Write and publish tweets to X (Twitter) with AI — topic research via YouMind knowledge base,
280-char optimized writing, numbered multi-tweet sequences, and one-click publishing through
the X account already connected in YouMind.
Use when user wants to "tweet", "post on X", "publish to Twitter", or "write a thread".
Write and publish tweets to X (Twitter) with AI — topic research via YouMind knowledge base,
280-char optimized writing, numbered multi-tweet sequences, and one-click publishing through
the X account already connected in YouMind.
Use when user wants to "tweet", "post on X", "publish to Twitter", or "write a thread".
triggers
["tweet","x post","twitter post","publish to x","post on x","write thread","tweet thread","x thread","twitter thread","推特","发推","推特帖子","写推文"]
["Bash(node dist/cli.js *)","Bash(npm install)","Bash(npm run build)"]
AI X (Twitter) Post Writer
Write viral tweets with AI. Topic research via YouMind knowledge base, 280-character optimized writing, numbered multi-tweet sequences, and one-click publishing to X through the X account already connected in YouMind.
Canonical credentials: put your shared YouMind credentials in ~/.youmind/config.yaml — filled ONCE and read by every YouMind skill. See shared/config.example.yaml for the template and shared/YOUMIND_HOME.md. Optional skill overrides live in ~/.youmind/config/youmind-x-article.yaml.
Step 3 -- Get YouMind API Key
YouMind API Key enables knowledge base search, web search, article archiving, and X publishing.
Fill in ~/.youmind/config.yaml under youmind.api_key
Keep youmind.base_url as https://youmind.com/openapi/v1 in examples and documentation. Local backend testing should only override ~/.youmind/config.yaml or ~/.youmind/config/youmind-x-article.yaml.
Step 4 -- Connect X in YouMind
Open YouMind and connect your X account via the product's publishing / connector settings flow (one-click OAuth 2.0 PKCE)
Save the connection once
Keep only youmind.api_key in ~/.youmind/config.yaml
Verify Setup
cd toolkit && npx tsx src/cli.ts validate
Validation checks only the ~/.youmind API key. X connectivity and plan eligibility are validated on the first publish call:
If the current plan is not eligible, the OpenAPI returns 402 with an upgrade link to https://youmind.com/pricing.
If the X account is not connected, the OpenAPI returns 404 X_ACCOUNT_NOT_CONNECTED. Connect the X account in the YouMind connector settings.
Skill Directory
This skill is a folder. Read files on demand -- do NOT load everything upfront.
Path
Purpose
When to read
references/pipeline.md
Full step-by-step execution
When running the publishing pipeline
references/platform-dna.md
X audience, format constraints, engagement data
Before any content work
references/content-generation-playbook.md
Idea → X-native draft workflow
When generating new content
references/content-adaptation-playbook.md
Existing article → X thread workflow
When adapting/condensing content
references/content-adaptation.md
X content formatting rules (legacy)
Supplementary reference
references/api-reference.md
YouMind X OpenAPI endpoint documentation
When calling X through YouMind
~/.youmind/config.yaml
Shared API credentials (YouMind only)
Step 1
output/
Local tweet Markdown drafts (git-ignored)
When writing the tweet/sequence
toolkit/dist/*.js
Executable scripts (run from toolkit/)
Various steps
Draft Location Rule
Canonical: write local tweet Markdown files to ~/.youmind/articles/x/<slug>.md. This shared home directory is available to all YouMind skills — see shared/YOUMIND_HOME.md.
Legacy fallback (if ~/.youmind/ is not writable): skills/youmind-x-article/output/<slug>.md.
Wrong: skill root directly, references/, toolkit/, or an ad-hoc drafts/ directory
Both locations are git-ignored. Create directories on demand (mkdir -p ~/.youmind/articles/x). Kebab-case filenames (my-thread.md), descriptive slugs over timestamps.
Content Modes
Before writing any content, read references/platform-dna.md to internalize X's format constraints, discourse norms, and engagement patterns (557M MAU, thread 2–4% engagement vs single-tweet 0.5–1.5%).
Self-critique: Pass all checklist items in the playbook's Step 6
Conformance report: Generate and present to user (Step 7/8)
User approval: Do not auto-publish without confirmation
Result Links Rule
After any tweet or thread publish action, always end with Result links.
Prefer the direct X post URL(s).
For threads, include the lead tweet URL plus any additional per-post URLs already available.
If no exact results page exists, return the best X platform entry URL instead.
Never leave the user with only raw post IDs.
Pipeline Overview
Read references/pipeline.md for full execution details.
Step
Action
Key reference
1
Load config and validate the YouMind API key
--
2
Mine YouMind knowledge base for source material
--
3
Research topic via web search
--
4
Adapt content: 280 char limit, split into sequence if long
references/content-adaptation.md
5
Publish to X via YouMind X OpenAPI
references/api-reference.md
6
Report results: post IDs, X URLs, result links
Routing shortcuts:
User gave a short topic → Skip broad research, go to Step 4
User gave raw tweet text → Skip to Step 5 (publish)
User wants preview only → Run local adaptation, skip publishing
Content Rules
Single Tweet
280 character limit — hard limit, no exceptions
URLs count as 23 characters — regardless of actual length
1-2 hashtags max — more looks spammy on X
Strong hook — first words determine if people read further
Clear opinion or insight — vague tweets get ignored
Thread (Tweet Chain)
First tweet = hook — must stand alone and compel reading
Each tweet makes sense alone — readers may see any tweet individually
Numbered format — 1/N style for clarity (optional but recommended)
Last tweet = CTA/summary — recap and call to action
280 chars per tweet — including numbering
Natural paragraph boundaries — split at logical breaks
Threads publish as a native X reply-chain: the skill takes the first tweet's postId and passes it as replyToPostId for the second tweet, and so on. X renders the full sequence as a proper thread in readers' timelines.
Images
Images must already be hosted under https://cdn.gooo.ai/... (YouMind enforces this allowlist to avoid SSRF)
Upload local files to YouMind first (e.g., via the YouMind product UI or AI image generation), then reference the returned CDN URL
Up to 4 images per tweet; for a sequence they attach to the first tweet only
Resilience: Never Stop on a Single-Step Failure
Every step has a fallback. If a step AND its fallback both fail, skip and note it in the final output.
Step
Fallback
2 Knowledge mining
Skip, empty knowledge context
3 Research
Ask user for manual input
5 Publishing
Save adapted text locally under output/ for manual posting
