buttondown
Create, update, inspect, and send test previews of Buttondown newsletter emails through the Buttondown API. Use when Codex needs to post newsletter copy as a Buttondown draft, manage Buttondown email drafts, preview draft emails to specific recipients, or inspect Buttondown email metadata. Defaults to draft-only and requires explicit user approval before sending, scheduling, publishing, deleting, or emailing previews.
- License 许可
- MIT
- 最近更新
- 2026-06-10
- Stars
- ★ 3
- Forks
- 0
01 前言 Front Matter
- name
- buttondown
- metadata
- { "openclaw": { "emoji": "✉️", "envVars": [ { "name": "BUTTONDOWN_API_KEY", "required": true, "description": "Buttondown API key. Store it in your shell, launcher, runtime secret store, or OpenClaw SecretRef; never commit it." }, { "name": "BUTTONDOWN_CONTEXT", "required": false, "description": "Optional Buttondown newsletter username for accounts that manage more than one newsletter." } ], "homepage": "https://forge.rayhollister.com/rayhollister/buttondown" } }
- description
- Create, update, inspect, and send test previews of Buttondown newsletter emails through the Buttondown API. Use when Codex needs to post newsletter copy as a Buttondown draft, manage Buttondown email drafts, preview draft emails to specific recipients, or inspect Buttondown email metadata. Defaults to draft-only and requires explicit user approval before sending, scheduling, publishing, deleting, or emailing previews.
03 SKILL.md 正文
Buttondown
Use Buttondown's API to create and manage newsletter email drafts.
Safety Defaults
- Draft-first: when creating an email, set
status: draftunless the user explicitly approves a different status in the current conversation. - Do not send, schedule, publish, delete, or send draft previews without explicit user approval in the current conversation.
- Do not put API keys in chat, command history, repo files, draft bodies, logs, or screenshots.
- Read the Buttondown API key from
BUTTONDOWN_API_KEY. Store it in your shell, launcher, runtime secret store, or OpenClaw SecretRef; never ask the user to paste the token into chat. - If using a platform account for multiple newsletters, pass the Buttondown newsletter username through
--contextorBUTTONDOWN_CONTEXT.
Configuration
The bundled CLI reads the API key from:
export BUTTONDOWN_API_KEY="..."
Prefer setting this through your runtime's secret manager or environment injection rather than typing it into a command. In OpenClaw, configure it through a SecretRef or equivalent managed environment variable.
Optional environment:
BUTTONDOWN_CONTEXT- newsletter username for theButtondown-Contextheader.BUTTONDOWN_API_BASE- defaults tohttps://api.buttondown.com/v1.
CLI
Run commands from the skill directory:
python3 scripts/buttondown.py create-draft --subject "Subject" --body-file issue.md
python3 scripts/buttondown.py create-draft --subject "Subject" --body-file issue.md --slug "issue-1" --description "SEO/archive summary"
python3 scripts/buttondown.py create-draft --subject "Subject" --body-file issue.md --editor-mode plaintext
python3 scripts/buttondown.py update-draft <email_id> --subject "New subject" --body-file issue.md
python3 scripts/buttondown.py list --status draft
python3 scripts/buttondown.py get <email_id>
python3 scripts/buttondown.py render <email_id>
python3 scripts/buttondown.py send-draft <email_id> --recipient user@example.com
Use --dry-run on write commands to inspect the request without calling Buttondown:
python3 scripts/buttondown.py create-draft --subject "Subject" --body-file issue.md --dry-run
Workflow
- Prepare clean Markdown or HTML body content in a local file.
- Remove YAML frontmatter from the body before uploading. Buttondown rejects bodies that start with frontmatter.
- Create the draft with
create-draft; confirm the response containsstatus: draft. - Share the Buttondown email ID and archive/admin URL from the response when available.
- For a preview email, show the user the target recipient(s) and get explicit approval, then run
send-draft.
Body Format
Buttondown detects Markdown versus HTML automatically. To force the editor mode, pass:
--editor-mode plaintextfor Markdown.--editor-mode fancyfor rich HTML.
The CLI prepends the official Buttondown editor-mode comment when this option is set.
API Reference
Read references/api.md when you need endpoint details, request fields, status values, error codes, or direct curl equivalents.
04 同仓库更多 Skills
youtube-content
YouTube transcripts to summaries, threads, blogs.
xurl
X/Twitter via xurl CLI: post, search, DM, media, v2 API.
touchdesigner-mcp
Control a running TouchDesigner instance via twozero MCP — create operators, set parameters, wire connections, execute Python, build real-time visuals. 36 native tools.
test-driven-development
TDD: enforce RED-GREEN-REFACTOR, tests before code.
teams-meeting-pipeline
Operate the Teams meeting summary pipeline via Hermes CLI — summarize meetings, inspect pipeline status, replay jobs, manage Microsoft Graph subscriptions.
systematic-debugging
4-phase root cause debugging: understand bugs before fixing.