| 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"] |
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:
python3 skills/slack-drafts/scripts/slack_drafts.py create --to '#general' --text 'hello'
python3 skills/slack-drafts/scripts/slack_drafts.py create --to '@jane' --text-file body.txt
python3 skills/slack-drafts/scripts/slack_drafts.py create --to C0123ABCDEF --thread-ts 1712345678.000100 --text '...'
python3 skills/slack-drafts/scripts/slack_drafts.py resolve --to '#general'
--to takes 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-ts targets 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:write scope; tokens connected before that
scope existed can only draft into conversations that already exist. On a
missing_scope error, 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.
