x-publisher
Draft, validate, split into threads, open X/Twitter composer links, and use the dry-run-first MCP workflow for live X posting when local credentials are explicitly configured. Use when Codex needs to prepare social launch copy, repo/project announcements, X posts, tweet threads, or shareable publishing drafts where the user should manually review before posting.
- License 许可
- MIT
- 最近更新
- 2026-11-12
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- x-publisher
- description
- Draft, validate, split into threads, open X/Twitter composer links, and use the dry-run-first MCP workflow for live X posting when local credentials are explicitly configured. Use when Codex needs to prepare social launch copy, repo/project announcements, X posts, tweet threads, or shareable publishing drafts where the user should manually review before posting.
02 资源文件 22
- 其他.env.example591 B
- 其他.gitignore67 B
- 参考文档agents/openai.yaml246 B
- 参考文档README.md2.0 KB
- 参考文档references/mcp-usage.md1.3 KB
- 参考文档references/posting-workflow.md1.2 KB
- 参考文档references/x-api-mcp-v2.md1.7 KB
- 参考文档requirements.txt14 B
- 脚本scripts/list_mcp_tools.py317 B
- 脚本scripts/start_mcp.py307 B
- 脚本scripts/x_publish.py9.1 KB
- 脚本tests/test_mcp_tools.py8.3 KB
- 脚本tests/test_x_publish.py2.8 KB
- 脚本tools/install_local.py1.5 KB
- 脚本x_publisher_mcp/__init__.py148 B
- 脚本x_publisher_mcp/__main__.py83 B
- 脚本x_publisher_mcp/backend.py9.3 KB
- 脚本x_publisher_mcp/config.py1.9 KB
- 脚本x_publisher_mcp/post_text.py5.5 KB
- 脚本x_publisher_mcp/registry.py3.6 KB
- 脚本x_publisher_mcp/server.py2.7 KB
- 脚本x_publisher_mcp/tools.py11.8 KB
03 SKILL.md 正文
X Publisher
Overview
Prepare X posts safely from local drafts. V1 creates validated composer links; v2 adds a dry-run-first MCP server in the source repo for curated posting and account-management workflows. Live posting is opt-in only and still requires exact confirmation.
Workflow
- Draft concise post text in the user's voice and keep the strongest point first.
- Run
scripts/x_publish.py validatebefore sharing any post or thread. - Use
scripts/x_publish.py intentfor a single post composer link. - Use
scripts/x_publish.py threadfor long Markdown/text drafts. - Tell the user that the browser composer is the final review step and they must click Post manually unless they explicitly ask for the v2 live MCP workflow and local credentials are configured.
Commands
Run commands from this skill folder:
python scripts/x_publish.py draft --text "Shipped x-publisher v1: local drafts, validation, threading, and X composer links."
python scripts/x_publish.py validate --text "Shipped x-publisher v1" --url "https://github.com/realsudarshan/SD-skill"
python scripts/x_publish.py intent --text "Shipped x-publisher v1" --url "https://github.com/realsudarshan/SD-skill"
python scripts/x_publish.py thread --file post.md
Add --open to intent only after the generated URL looks correct.
Guardrails
- Do not post directly from the v1 CLI. If asked for direct posting, use the v2 MCP guidance in
references/mcp-usage.md, require exact confirmation for mutating tools, and keep live credentials in environment variables only. - Do not request or store X API keys in prompts or committed files.
- Treat local character counts as a conservative approximation. For direct API posting, re-check current X docs and use the official
twitter-textguidance. - Prefer shortening the draft before splitting into a thread unless the user explicitly wants a thread.
- Treat the source repo as authoritative. Sync the installed skill from the source repo with
python tools/install_local.py.
References
references/posting-workflow.md: Practical draft, validation, and composer-link workflow.references/mcp-usage.md: How to list and run the v2 MCP server.references/x-api-mcp-v2.md: Notes for the full X API MCP/plugin direction.
04 同仓库更多 Skills
winui-app
Bootstrap, develop, and design modern WinUI 3 desktop applications with C# and the Windows App SDK using official Microsoft guidance, WinUI Gallery patterns, Windows App SDK samples, and CommunityToolkit components. Use when creating a brand new app, preparing a machine for WinUI, reviewing, refactoring, planning, troubleshooting, environment-checking, or setting up WinUI 3 XAML, controls, navigation, windowing, theming, accessibility, responsiveness, performance, deployment, or related Windows app design and development work.
vercel-deploy
Deploy applications and websites to Vercel. Use when the user requests deployment actions like "deploy my app", "deploy and give me the link", "push this live", or "create a preview deployment".
security-best-practices
Perform language and framework specific security best-practice reviews and suggest improvements. Trigger only when the user explicitly requests security best practices guidance, a security review/report, or secure-by-default coding help. Trigger only for supported languages (python, javascript/typescript, go). Do not trigger for general code review, debugging, or non-security tasks.
playwright
Use when the task requires automating a real browser from the terminal (navigation, form filling, snapshots, screenshots, data extraction, UI-flow debugging) via `playwright-cli` or the bundled wrapper script.
openai-docs
Use when the user asks how to build with OpenAI products or APIs and needs up-to-date official documentation with citations, help choosing the latest model for a use case, or model upgrade and prompt-upgrade guidance; prioritize OpenAI docs MCP tools, use bundled references only as helper context, and restrict any fallback browsing to official OpenAI domains.
netlify-deploy
Deploy web projects to Netlify using the Netlify CLI (`npx netlify`). Use when the user asks to deploy, host, publish, or link a site/repo on Netlify, including preview and production deploys.