All skills
richtabor avatar

/x-writing

@a91522c
by Rich Taborrichtabor/agent-skills72 stars
10

Transforms notes into X (Twitter) posts. Triggers when user asks to create social content, draft tweets, or turn notes/ideas into posts.

Use this Skill: https://skilld.dev/gh/richtabor/agent-skills/x-writing

This session only. Nothing lands on disk.

referencesx-strategy.md

≈3.3k tokens on demand. Your agent reads this file only when SKILL.md points to it.

X Content Strategy

Reference for creating X content that builds audience and generates business. Focus on high-value, consistent posting.


Core Philosophy

Volume + Value = Growth

Post consistently (3+ times daily) with genuinely valuable content. Not everything will perform—even great insights flop due to writing or algorithm. Success comes from consistency and helping people solve real problems.

The goal: Build an audience that respects your ideas, not just follower count. When people stop scrolling because they recognize your name, you've won.


Three Pillars of Effective Content

Every post needs all three. Miss one and it likely flops.

1. Genuinely Valuable

Fresh insights from real experience, not recycled advice said a thousand times.

  • Pull from your actual work and discoveries
  • Share what surprised you or changed your approach
  • Contradict common assumptions with specifics
  • Help people skip mistakes you made

Test: Would I bookmark this if someone else wrote it?

Examples:

  • ✓ "Agent discovery is fundamentally different from app discovery. Apps are static—you search features. Agents are conversations—you can't describe all possible conversations."
  • ✗ "Discovery is important for products"

Specificity builds credibility:

  • ✓ "Claude Code cut deployment time from 4 hours to 20 minutes"
  • ✗ "This tool is amazing"

Note: Shitposting rarely works. A few people do it well, but most fail when they try.

2. Immediately Actionable

Give people a system they can implement today.

Pure observation gets views. Teaching implementation gets followers and business.

  • Don't just point at something, show how to use it
  • Walk through the actual process step-by-step
  • Make it immediately applicable to their workflow

Examples:

  • ✗ "The new ChatGPT update is incredible"
  • ✓ "How to write copy that sounds human with GPT-4.5: [step-by-step process]"

Tweets become your portfolio. Consistent how-to content proves expertise and leads to business naturally.

3. Sparks Natural Engagement

Never beg for engagement. Structure content so bookmarks and replies happen organically.

Trigger Bookmarks:

Use hooks that signal immediate value:

  • "How to [solve problem]"
  • "Here's what I learned [doing X]"
  • "Do this before [common action]"

People on autopilot bookmark useful-looking content instantly.

Drive Replies:

Option A: Strong opinion

  • Make a specific, controversial claim
  • People argue or support—both drive engagement
  • Example: "GPT-4.5 writes better copy than Claude, Gemini, and Grok combined"

Option B: Collaborative invitation

  • Leave room for others to share their approach
  • Feels inclusive, gets experience-sharing
  • Example: "This is my workflow with ChatGPT—curious if anyone's tested this with Claude"

Content Selection Framework

High Priority → Always Share

Shipped work + learnings

  • What you built (specific)
  • One key insight from building it
  • Why it matters

Non-obvious insights

  • What surprised you
  • Why it contradicts expectations
  • How it changes your approach

Tool recommendations

  • What it does
  • Specific benefit (numbers, time saved)
  • Real example from your use
  • Only share tools you actually use

Solutions to common problems

  • The specific problem
  • Why obvious solutions failed
  • What actually worked
  • The key insight

Counter-intuitive patterns

  • The observation
  • Why it's unexpected
  • Practical implications

Medium Priority → Consider

Industry takes with unique angle

  • Your specific perspective from real work
  • Why it matters
  • Concrete evidence

Avoid: "AI is changing everything" (generic) Do: "Everyone talks about AI speed. What matters: maintaining voice at scale."

Process improvements

  • Must include concrete examples and outcomes

Technical decisions

  • Share the context and reasoning

Genuine questions

  • Ask about specific approaches, not vague "thoughts?"

Skip These

Low Priority:

  • Progress updates without insights
  • Plans before execution (share when shipped)
  • Obvious observations
  • Feelings about work without value
  • Meta-posting about posting

Never Share:

  • Engagement bait ("RT if you agree")
  • Generic motivation ("Never give up!")
  • Vague hype without specifics
  • Complaints without solutions
  • Announcements of announcements

Red flags in notes: If you see these phrases, usually skip:

  • "Just wanted to share..."
  • "Random thought..."
  • "Does anyone else..."
  • "Feeling grateful..."

Formatting & Structure

How to format content for X specifically. Visual structure determines whether people read or bounce.

Hook First

First line IS the tweet. No preamble.

Common hooks:

  • "How to [X]"
  • "Why [X] doesn't work"
  • "[X] is [Y]"
  • "Shipped [X]"
  • "Here's what I learned:"

Visual Rules

One sentence per line. Creates natural rhythm, easier to process visually.

White space between lines/sections. Dense text blocks feel exhausting on X.

Use lists for complexity:

  • Bullet points ("-" or ">") for steps/ideas
  • Numbered lists for sequences
  • People skim and grab main points

No italics. Formatting breaks on X. Use emphasis through word choice: "literally," "actually," "exactly."

Length

Target 180-250 characters. Leave room for RTs.

The Formula

For most tweets: [Specific action/observation] + [Why it matters] + [Your take/learning]

Examples:

"Shipped curation for agents.foo. Discovery is way harder than app stores. Agents are conversations, not static downloads. Totally different problem."

"Claude Code cut dev time from days to hours. Not because it writes better code. Because it handles the boring parts automatically."

"Everyone wants AI to sound human. Few actually build quality checks. Speed ≠ authenticity."

Signature Patterns

Common opening patterns:

Opening Usage
"Shipped [X]" Project updates
"Here's what I learned:" Insight posts
"[X] is [Y]" Direct statements
"Wild how..." Genuine surprise
"Most people [X]. But..." Challenge pattern
"How to [X]" Tutorial/guide posts

Common closing patterns:

Closing Usage
"More on this soon." Teaser
"What's your approach?" Question
"Pretty cool." Understated excitement
"That's it." Hard stop
No closing Let the insight land

Good vs Bad Examples

Good: "Workflow DevKit is wild. Built-in durability, automatic retries, state persistence. Ships with Next.js. Would take weeks to build manually."

Why: Specific tools, concrete benefits, genuine reaction, personal experience

Good: "Shipped agents.foo curation v1 today. Discovery is the hardest part. Agents aren't apps—they're conversations. Traditional app store UX doesn't work here."

Why: Real project, specific insight, clear problem statement

Bad: "Just shipped something cool! Really excited about this game-changing feature. It's going to revolutionize how we think about discovery. Thoughts?"

Why: Vague, banned phrases, generic closing, no specifics

Bad: "Hot take: AI is the future of product development. We need to leverage these tools to unlock new possibilities. What do you think?"

Why: Empty statement, corporate speak, no personal experience, generic question


High-Engagement Patterns

Pattern 1: "Shipped X, Learned Y"

Combine progress with insight.

Structure:

  • What you shipped (specific)
  • Key learning
  • Why it matters

Example: "Shipped curation v1 for agents.foo.

Traditional search patterns fail for agents—they're conversations, not feature lists.

Rebuilt discovery around context matching instead."

Pattern 2: "Here's What I Learned"

Share non-obvious insights.

Structure:

  • State the learning directly
  • Brief context
  • Why it's counter-intuitive
  • How you're applying it

Example: "Agent discovery is fundamentally different from app discovery.

Apps are static—search features, read descriptions, install.

Agents are conversations. You can't describe all possible conversations.

The UX isn't search. It's contextual matching."

Pattern 3: "How to Do X"

Step-by-step tactical content. Highly bookmarkable.

Structure:

  • "How to [solve specific problem]"
  • Clear steps (bulleted or numbered)
  • Why this approach works
  • Optional: Engagement question

Example: "How to maintain voice at scale with AI:

  • Set up quality gates before shipping
  • Use custom style guides, not generic prompts
  • Review first 50 outputs manually to tune
  • Monitor consistency metrics weekly

Speed means nothing if your voice disappears."

Pattern 4: Problem → Solution

Show how you solved something specific.

Structure:

  • The specific problem
  • Why obvious solutions failed
  • What actually worked
  • Key insight

Example: "Problem: Can't describe agent conversations like app features.

First try: Traditional search. Failed—keywords don't capture conversational capability.

What worked: Context matching based on what the agent does in conversation.

Discovery UX follows the product paradigm."

Pattern 5: Specific vs Generic

Challenge vague industry wisdom.

Structure:

  • Common wisdom (vague)
  • Specific reality from your work
  • Why the difference matters

Example: "Everyone says AI should sound human.

But 'human' is vague. What actually matters: consistent voice, clear reasoning, genuine personality.

Most tools optimize for speed over authenticity."

Pattern 6: Tool Recommendation

Share tools that measurably helped.

Structure:

  • Tool name
  • Specific benefit (numbers/time)
  • What it handles you'd otherwise build
  • Real use case

Example: "Workflow DevKit handles agent durability automatically.

Built-in retries, state persistence, observability. Would take weeks to build.

Using it for all agents.foo workflows. Saved ~3 weeks dev time."


Thread Strategy

When to Thread (2-5 tweets)

  • Narrative with steps ("How we built X")
  • Multiple related insights ("3 learnings about X")
  • Before/after story ("Tried X, failed, here's what worked")

When to Use Single Tweets

  • One clear insight
  • Quick updates
  • Strong observations
  • Tool recommendations

Default to single tweets. Only thread when the story requires it.

Thread Structure

  • Tweet 1: Hook with main insight (most important)
  • Tweets 2-4: Build with specifics, examples, details
  • Final tweet: Land with question or strong statement

Each tweet must work standalone. People should be able to RT any tweet and it makes sense.

No numbering. No "1/5" markers.

Max 5 tweets. Longer = blog post territory.


What Makes Content Shareable

People RT:

  • Specificity (concrete details vs vague claims)
  • Insights (non-obvious learnings)
  • Utility (actionable knowledge)
  • Relatability (shared struggles + specific solutions)

People Reply When You:

  • Ask specific questions (not "what do you think?")
  • Make specific, debatable claims
  • Show genuine curiosity
  • Leave room for others to add their perspective

Tease follow-ups. "More on this soon" or "Writing about this next week" creates anticipation and signals ongoing depth.


Recognizable Style Development

Generic content blends together. Distinctive style makes people stop scrolling.

Your style = your signature

Develop 3-4 structural patterns that feel natural:

  • Specific opening phrases
  • Consistent formatting (like using ">" for lists)
  • Particular ways you emphasize points
  • Phrases you use before certain types of takes

Consistency without formula. Patterns should be recognizable but not templated.

Examples:

  • Always using ">" to break down processes
  • Starting tool recs with "X handles Y automatically"
  • Using "tbh" or "honestly" before controversial takes
  • Writing in fragments for emphasis

Pre-Post Checklist

Value:

  • Teaches something specific
  • Saves time or helps avoid mistakes
  • From genuine experience
  • Would I bookmark this?

Specificity:

  • Names tools, projects, or numbers
  • Includes concrete examples
  • Avoids vague adjectives

Actionability:

  • Can someone implement today?
  • Shares HOW, not just WHAT

Clarity:

  • One clear idea
  • Hook in first line
  • Every word earns its place

Engagement:

  • Invites response naturally
  • Specific enough to discuss
  • Will trigger bookmarks or replies

Content Mix (Weekly)

Over 21 posts per week:

  • 8 posts (38%): Educational/How-to
  • 6 posts (29%): Personal updates (what you shipped)
  • 4 posts (19%): Insights/observations
  • 3 posts (14%): Questions/engagement

Don't optimize daily. Post valuable content, mix balances naturally.


The Outcome

Consistent high-value posting builds:

  • Audience that respects ideas, not just follower count
  • People who stop scrolling when they see your name
  • Trust through demonstrated expertise
  • Natural conversion when selling (they've already experienced your teaching)

Final test: "Would I want to read this if someone else posted it?"

If yes → share. If no → back to notes.

Source: SKILL.md on GitHub

3 warnings9d4 checks · Risk MEDIUM
  • Gen Agent Trust Hub9d

    The skill is functional for social media drafting but contains a security vulnerability in the helper script used to fetch macOS notes. This script allows for AppleScript injection if input arguments or environment variables contain malicious code. Additionally, the skill processes external data from notes and files without sanitization, making it susceptible to indirect prompt injection.

  • Socket9d

    1 alert: gptAnomaly

  • Snyk9d

    Risk: LOW · No issues

  • Runlayer7mo

    5/5 files flagged

Signed by skilld at a91522c. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 2 months ago.

Steadyupdated 8 months ago

README badge

README badge for richtabor/agent-skills/x-writing