slack-drafts
Create Slack message drafts in the user's own composer, as the user, through their per-user Slack OAuth. Drafting only — the user reviews and sends from Slack.
- License 许可
- MIT
- 所属仓库
- yc-software/qm
- 最近更新
- 2026-11-15
- Stars
- ★ 1.6w
- Forks
- 2.0k
01 前言 Front Matter
- name
- slack-drafts
- description
- Create Slack message drafts in the user's own composer, as the user, through their per-user Slack OAuth. Drafting only — the user reviews and sends from Slack.
- requiredCapabilities
- [ "egress:slack.com" ]
02 资源文件 1
- 脚本scripts/slack_drafts.py6.3 KB
03 SKILL.md 正文
Slack drafts
Use this skill when the user wants a Slack message prepared for them to review and send themselves: "draft a reply to X", "prep a message for #general", "write that up as a Slack draft". The draft lands in their own Slack composer, attributed to them, targeted at the conversation you choose — nothing is posted.
This is an OAuth connector. The resolved user's Slack user token lives on your
computer as $VAULT_TOKEN_SLACK_COM. Do not ask the user for a token, log it, or
use another principal's. If the variable is empty or Slack returns 401/403, the user
either has not connected Slack or connected before this permission existed — tell
them to (re)connect it through the product OAuth flow.
Use the bundled helper for every draft — it owns destination resolution, rich-text block construction, and the required draft envelope:
Run these commands with execute and an explicit sandbox_id, using the absolute
directory reported by the skill read in place of <skill dir>. Keep that ID for
preparing body files and running the helper.
python3 "<skill dir>/scripts/slack_drafts.py" create --to '#general' --text 'hello'
python3 "<skill dir>/scripts/slack_drafts.py" create --to '@jane' --text-file body.txt
python3 "<skill dir>/scripts/slack_drafts.py" create --to C0123ABCDEF --thread-ts 1712345678.000100 --text '...'
python3 "<skill dir>/scripts/slack_drafts.py" resolve --to '#general'
--totakes a channel/IM ID (C…/G…/D…), a user ID (U…/W…),#channel-name, or@name(matched against username, display name, real name, or email; ambiguous matches are refused — fall back to a user ID).- Text is plain; URLs become clickable links. Write it exactly as the user would send it — it goes out under their name, in their voice, once they hit send.
--thread-tstargets the draft at a thread reply instead of the channel composer.- Drafts are create-only through this API: you cannot list, edit, or delete a draft once made. To revise, tell the user to discard the old draft in Slack and create a fresh one. Never work around this by posting messages — drafting means the user sends.
- Opening a brand-new DM needs the
im:writescope; tokens connected before that scope existed can only draft into conversations that already exist. On amissing_scopeerror, tell the user to reconnect Slack. - Slack keeps at most one draft per composer: a second draft into the same channel or
thread fails with
attached_draft_exists. Tell the user to send or discard the existing draft, then retry.
04 同仓库更多 Skills
zoom
Find, create, reschedule, and cancel the user's Zoom meetings through their own Zoom connection.
use-shared-credential
When you need to call a service the org has a SHARED credential for (a SERP/search key, a paid-API key, a data-vendor feed, a Git remote) — and the platform has told you that credential is available to this conversation — make the call BY PROXY through the credential broker. You never see the secret; the core stamps it onto the outbound request for you.
ui-state
See what the person is looking at in the QM web UI right now — the whole page (sidebar, every multiview pane, open dialogs) as raw HTML, the app's state as JSON, optionally the CSS and a screenshot. Use when they ask about something on their screen, want help with the UI, or you need to check what a canvas you wrote actually rendered.
ui-canvas
Draw your own HTML/CSS/JS as a full-window overlay on top of the QM web UI — a dashboard, a form, a visualization, controls that message you back. Write, update, replace, pin or dismiss it. Use when an interactive or visual result beats a chat reply.
taste-skill
Design taste and process for anything a person will look at in a browser — landing page, dashboard, prototype, deck. The default design driver for a browsable artifact, with an anti-slop playbook for the visual language.
send
Make a PR, wait for CI with bounded transport retries, run the repo's required reviews, and merge only when all gates pass.