youmind-x-article

Imported from youmind-openlab/skills (skills/youmind-x-article/SKILL.md). Install upstream with npx skills add youmind-openlab/skills --skill youmind-x-article. Copyright stays with the author.

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.

Get YouMind API Key | More Skills

Onboarding

MANDATORY: When the user has just installed this skill, present this message IMMEDIATELY. Translate to the user's language:

AI X Post Writer installed!

Tell me your topic and I'll write and publish a tweet for you.

Try it now: "Write a tweet about the future of open source AI"

What it does:

• Research topics from your YouMind knowledge base and web trends
• Write tweets optimized for engagement within 280 characters
• Split long content into numbered tweet sequences (1/N format)
• Publish directly to X through the X account connected in YouMind

Setup (one-time):

1. Install & configure: cd toolkit && npm install && npm run build && cd .. && mkdir -p ~/.youmind/config && cp shared/config.example.yaml ~/.youmind/config.yaml
2. Get YouMind API Key and fill youmind.api_key in ~/.youmind/config.yaml
3. Connect your X account inside YouMind before publishing. This skill no longer reads X developer keys locally.
4. Publishing requires a paid YouMind plan (Pro / Max) and consumes YouMind credits per tweet.

No X connection yet, or on a free plan? You can still write and preview locally — just skip the publish step.

Need help? Just ask!

Usage

Provide a topic, talking points, or raw text for publishing.

Write a single tweet:

Write a tweet about the latest AI breakthrough

Write a multi-tweet sequence:

Write a thread explaining how transformers work, aimed at beginners

Publish raw text:

Tweet this: "Just shipped our new feature! Here's what we learned..."

Setup

Prerequisites: Node.js >= 18, a YouMind API key, a Pro/Max YouMind plan, and an X account connected in YouMind if you want to publish.

Step 1 -- Install Dependencies

cd toolkit && npm install && npm run build && cd ..

Step 2 -- Create Config File

mkdir -p ~/.youmind/config
cp shared/config.example.yaml ~/.youmind/config.yaml

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.

1. Open YouMind API Keys
2. Click Create API Key
3. Copy the sk-ym-xxxx key
4. Fill in ~/.youmind/config.yaml under youmind.api_key
5. 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

1. Open YouMind and connect your X account via the product's publishing / connector settings flow (one-click OAuth 2.0 PKCE)
2. Save the connection once
3. 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.

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.

• Correct: ~/.youmind/articles/x/my-thread.md
• Correct (legacy): skills/youmind-x-article/output/my-thread.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%).

Intent routing

Quality gates (before publish)

1. Self-critique: Pass all checklist items in the playbook's Step 6
2. Conformance report: Generate and present to user (Step 7/8)
3. 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.

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

1. 280 character limit — hard limit, no exceptions
2. URLs count as 23 characters — regardless of actual length
3. 1-2 hashtags max — more looks spammy on X
4. Strong hook — first words determine if people read further
5. Clear opinion or insight — vague tweets get ignored

Thread (Tweet Chain)

1. First tweet = hook — must stand alone and compel reading
2. Each tweet makes sense alone — readers may see any tweet individually
3. Numbered format — 1/N style for clarity (optional but recommended)
4. Last tweet = CTA/summary — recap and call to action
5. 280 chars per tweet — including numbering
6. 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.

References

• YouMind X OpenAPI: see references/api-reference.md
• Content rules: see references/content-adaptation.md
• Pipeline: see references/pipeline.md
• YouMind Skills gallery: https://youmind.com/skills?utm_source=youmind-x-article