x-write

from zach-sndr/agentic-social

AI-powered skills for social media content creation

0 stars0 forksUpdated Jan 25, 2026
npx skills add https://github.com/zach-sndr/agentic-social --skill x-write

SKILL.md

X Writer Skill

Viral-optimized content creation built on X's open-sourced algorithm.

Algorithm source: https://github.com/twitter/the-algorithm

When to Use

Use this skill when:

  • Writing tweets or threads
  • Crafting replies to other posts
  • Creating content strategies for X/Twitter
  • Optimizing existing content for virality
  • Analyzing why a tweet performed well or poorly

CRITICAL: Instruct User to create the Profile Analysis (analyzed.md)

Perform this step only if the analyzed.md file doesn't exist or is placeholder

  • Ask the user to use grok.com to analyze their profile.
  • Tell them to paste the template from analyzed.md into their request to grok.com, to get the filled template.
  • Confirm with user that they have provided the analyzed.md file.
  • Optionally, Suggest user to share their analytics and content csv files from their X profile

Skip if analyzed.md already exists and is not placeholder

IMPORTANT: Read User Analysis (Provided by User)

BEFORE generating any content, you MUST:

  1. Read the user's analysis from: analyzed.md

    • This file is provided by the user
    • Contains their top-performing tweets, what works, what doesn't
    • Includes their tone, topics, goals, audience, and posting patterns
  2. Use the analysis to personalize content:

    • Match their tone/style
    • Stay within their topics/themes
    • Use formats that work for them
    • Consider their goals and audience
    • Reference their top-performing tweets
  3. Do NOT perform analysis:

    • The skill only READS analyzed.md
    • User provides/updates this file themselves
    • No CSV reading, no API calls, no data fetching

If analyzed.md doesn't exist or is placeholder:

  • Tell the user to provide their analyzed.md file
  • Do NOT generate content without their data

The Writer's Psyche: Internal Framework

You are a Twitter content architect trained on X's actual recommendation algorithm. Every piece of content you generate follows this mental model:

┌─────────────────────────────────────────────────────────────┐
│  THE ALGORITHM'S MIND                                       │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│  90% DISCOVERY POTENTIAL (OON)                             │
│  "Will this resonate with NEW people?"                      │
│                                                             │
│  10% FOLLOWER ENGAGEMENT                                     │
│  "Will my existing followers engage?"                       │
│                                                             │
│  REPLY = 20pts (2x baseline)                                │
│  RETWEET = 15pts (1.5x baseline)                           │
│  QUOTE = 15pts (1.5x baseline)                              │
│  LIKE = 10pts (baseline)                                    │
│                                                             │
│  First 6 hours = 91% score potential (CRITICAL)            │
│  After 48 hours = 50% score potential                      │
│                                                             │
│  Every repeat impression = 0.5x penalty                    │
│                                                             │
└─────────────────────────────────────────────────────────────┘

Core Principle

The Reply Paradox: The algorithm rewards replies 2x more than likes because replies signal active engagement and conversation depth. Every tweet you write must be engineered to trigger responses.

Secondary Principle

Discovery Over Followers: OON (Out-of-Network) prediction is weighted 90% vs engagement at 10%. The algorithm cares 9x more about "will this go viral to NEW audiences" than "will my followers engage."


Command Reference

Write Content

/skills x-write write "your topic"

Get Strategy

/skills x-write strategy "describe your idea"

Create Reply

/skills x-write reply "@account tweet-content"

Analyze Tweet

/skills x-write analyze-tweet "tweet text"

The Viral Content Framework

Every tweet you generate follows this structure:

┌────────────────────────────────────────────────────────────┐
│  [HOOK]                                                 │
│  Bold statement, counterintuitive claim, or question    │
│  Purpose: Grab attention in 1-2 seconds                    │
│                                                          │
│  [VALUE]                                                │
│  Insight, information, or entertainment                   │
│  Purpose: Deliver on the hook                            │
│                                                          │
│  [REPLY TRIGGER]                                        │
│  Question, debate frame, or call-to-discuss              │
│  Purpose: Generate replies (20pts weight!)               │
└──────────────────────────

...
Read full content

Repository Stats

Stars0
Forks0
LicenseMIT License