AGENT SKILL

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

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'
  • --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.

04 同仓库更多 Skills

yc-software
yc-software/qm

zoom

Find, create, reschedule, and cancel the user's Zoom meetings through their own Zoom connection.

★ 1.6w
yc-software
yc-software/qm

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.

★ 1.6w
yc-software
yc-software/qm

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.

★ 1.6w
yc-software
yc-software/qm

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.

★ 1.6w
yc-software
yc-software/qm

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.

★ 1.6w
yc-software
yc-software/qm

send

Make a PR, wait for CI with bounded transport retries, run the repo's required reviews, and merge only when all gates pass.

★ 1.6w