Agent skill

X Writer

by ognjengt in ognjengt/founder-skills

Creates viral X (Twitter) posts using proven formats, post templates, and creator voice matching.

MITAuto-check passedWriting & Content

Install X Writer

skills CLI
$ npx skills add ognjengt/founder-skills --skill x-writer -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install ognjengt/founder-skills x-writer --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/ognjengt/founder-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/x-writer .claude/skills/x-writer && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
x-writer
GitHub stars
447
Token cost
~3k tokens
SKILL.md length
1,425 words
Files
4 (incl. references)
Skills in repo
15
Repo updated
First seen
Licence
MIT

At a glance

Creates viral X (Twitter) posts using proven formats, post templates, and creator voice matching.

  • Works in 5 steps: MANDATORY: Read Reference Files FIRST → Check for Business Context → Analyze Input & Select Voice → …
  • User needs engaging
  • SKILL.md covers Purpose, Execution Logic, Task Execution and Writing Rules, plus 4 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

X Writer is an agent skill from ognjengt/founder-skills. Creates viral X (Twitter) posts using proven formats, post templates, and creator voice matching. Use when user needs engaging, high-performing posts for X/Twitter.

Its SKILL.md is about 3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including reference files (for example `references/formats.md`, `references/posts.md` and `references/voices.md`).

It sits in Writing & Content, covering Brand voice and tone. It works with X (Twitter). The repository describes itself as: Claude skills for founders. The licence is MIT.

When your agent uses it

  • User needs engaging
  • High-performing posts for X/Twitter

Example prompts

  • “Use the x-writer skill to create viral X (Twitter) posts using proven formats, post templates, and creator voice matching”
  • “/x-writer”

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. MANDATORY: Read Reference Files FIRST
  2. Check for Business Context
  3. Analyze Input & Select Voice
  4. Generate 3 Viral Posts
  5. Format and Verify

What it can do on your machine

Read from SKILL.md and the folder at commit a45931c. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are markdown).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

X Writer loads about 3k tokens when it runs, and up to ~11k if it reads all its reference files. Until then it costs about 43 tokens; SKILL.md has 1,425 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~43
When it runs · the whole SKILL.md, loaded when a task matches
~3k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~11k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from ognjengt/founder-skills at commit a45931c, republished under its MIT licence (© ognjengt). 1,425 words, ~2,954 tokens.

Download SKILL.mdSave it as .claude/skills/x-writer/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
x-writer
description
Creates viral X (Twitter) posts using proven formats, post templates, and creator voice matching. Use when user needs engaging, high-performing posts for X/Twitter.

X Writer

Purpose

Generate 3 viral X posts in different proven formats, matched to a creator voice, using battle-tested templates and patterns that drive engagement.


Execution Logic

Check $ARGUMENTS first to determine execution mode:

If $ARGUMENTS is empty or not provided:

Respond with: "x-writer loaded, proceed with your topic or idea"

Then wait for the user to provide their requirements in the next message.

If $ARGUMENTS contains content:

Proceed immediately to Task Execution (skip the "loaded" message).


Task Execution

When user requirements are available (either from initial $ARGUMENTS or follow-up message):

1. MANDATORY: Read Reference Files FIRST

BLOCKING REQUIREMENT — DO NOT SKIP THIS STEP

Before doing ANYTHING else, you MUST use the Read tool to read ALL three reference files. This is non-negotiable:

Read: ./references/formats.md
Read: ./references/posts.md
Read: ./references/voices.md

What you will find:

  • formats.md: 8 proven post formats with structure templates, psychology, and format-specific rules
  • posts.md: 49+ proven viral posts organized by format type — the example library
  • voices.md: Creator voice profiles with writing DNA, signature patterns, and example posts

DO NOT PROCEED to Step 2 until you have read all three files and have their content in context.

2. Check for Business Context

Check if FOUNDER_CONTEXT.md exists in the project root.

  • If it exists: Read it and use the business context to personalize output (industry terminology, audience pain points, brand voice, company name, products).
  • If it doesn't exist: Proceed using defaults from "Defaults & Assumptions."
3. Analyze Input & Select Voice

From the user's requirements, extract:

  • Topic/idea — What they want to post about
  • Goal — What they want the post to achieve (engagement, authority, education, humor)
  • Voice preference — If they specified a voice or tone

Voice Matching Logic:

If the user specified a voice → use that voice directly.

If the user did NOT specify a voice:

  1. Analyze the topic and FOUNDER_CONTEXT.md brand voice
  2. Auto-suggest the best match based on topic:
    • Business advice, mindset, pricing, sales, productivity → suggest Alex Hormozi
    • Life philosophy, contrarian takes, self-improvement, minimalism → suggest Naval Ravikant
    • Startup advice, CEO/founder roles, hiring, company building → suggest Andrew Gazdecki
    • Self-improvement, productivity hacks, fitness + learning, habits → suggest Dakota Robertson
    • AI trends, tool launches, tech stack recommendations, urgent opportunities → suggest Machina
    • SaaS growth, AI productivity, founder mindset, revenue strategy → suggest Ognjen Gatalo
    • Personal responsibility, escaping default paths, harsh reality checks, focus training → suggest Dan Koe
  3. Ask the user to confirm using AskUserQuestion:
    • [Suggested Voice] (Recommended) — [one-line description of why it fits]
    • [Other Voice 1] — [one-line description]
    • [Other Voice 2] — [one-line description]
    • My own voice — Natural tone based on FOUNDER_CONTEXT.md brand voice
4. Generate 3 Viral Posts

Using the formats, posts, and voice you loaded in Steps 1-3:

  1. Select 3 DIFFERENT formats from formats.md that best fit the user's topic and goal
  2. Study the example posts in posts.md for those formats — internalize the rhythm, structure, and length
  3. Apply the selected voice from voices.md — match their sentence structure, rhythm, and signature patterns (not their exact words or examples)
  4. Draft each post following the format's structure template, the voice's DNA, and all Writing Rules below
  5. Run each post through the Screenshot Test: "Would someone screenshot this and share it?" If no → rewrite before continuing

Critical requirements:

  • Each post must use a DIFFERENT format (no repeats)
  • Each post must sound like the selected voice (structural match, not word-for-word copy)
  • Each post must be about the user's SPECIFIC topic (not generic advice)
  • Each post must follow the format's structure template from formats.md
  • Each post must be ready to copy-paste and post immediately — no placeholders
5. Format and Verify
  • Structure output according to Output Format section
  • Complete Quality Checklist self-verification before presenting output
  • If any post feels generic, forced, or wouldn't pass the Screenshot Test → rewrite before presenting

Writing Rules

Hard constraints. No interpretation.

Core Rules (Apply to ALL posts)
  • Maximum 280 characters for single posts. If a post exceeds 280 characters, it must be structured as a thread (each tweet under 280 characters).
  • First line is the hook — it determines whether people click "Show more." Make it the strongest line in the post.
  • Use line breaks strategically. White space = visual breathing room = readability.
  • No hashtags. They reduce reach and look amateur on X.
  • No engagement bait ("like if you agree", "RT if this resonates", "thoughts?"). It kills reach.
  • No emojis unless the voice or topic specifically calls for it. When used, maximum 1-2 per post.
  • Specific numbers > vague claims ("17 strategies" not "many strategies").
  • Opinions > facts. X rewards bold takes, not Wikipedia summaries.
  • Active voice only. Never passive.
  • Present tense preferred.
  • Every word must earn its place. If you can cut a word without losing meaning, cut it.
  • No "I think" or "In my opinion" — just state the opinion as fact. Confidence is voice.
Voice-Matching Rules
  • Match the voice's SENTENCE STRUCTURE — short choppy lines vs flowing sentences, fragments vs complete thoughts.
  • Match their RHYTHM — how they pace ideas, where they place line breaks, how they build tension.
  • Match their PERSPECTIVE — coaching from authority (Hormozi) vs philosophical detachment (Naval) vs peer founder advice (Gazdecki).
  • Do NOT copy their exact phrases, examples, or company references. Create original content that SOUNDS like them structurally.
  • If the user chose "My own voice," use a natural, conversational tone that matches FOUNDER_CONTEXT.md brand voice. If no context exists, default to direct and conversational.
Show full SKILL.md (557 more words)Show less
Format-Specific Rules
  • One-Liners: One sentence. One idea. No explanations. Every word carries weight.
  • Two-Part Punch: Line break between parts. Second part MUST change the meaning of the first.
  • Numbered Lists: Odd numbers preferred. Each item must be specific and standalone. Strong, opinionated closer.
  • Stacked Progression: Same grammatical structure per line. Build momentum. The final line MUST break the pattern.
  • Comparison: Stark, obvious contrast. Don't lecture — let the contrast make the point.
  • Example + Takeaway: Use real, named companies or people. Minimum 3 examples. Actionable closer.
  • Reverse Advice: Deadpan delivery. No winking. Every item is a real mistake people make.
  • Humor: One joke per post. Deadpan > trying hard. Industry-specific > generic. Never explain the joke.
The Screenshot Test

Before finalizing ANY post, ask yourself: "Would someone screenshot this and share it with their group chat?" If the answer is no — the post isn't good enough. Rewrite it.


Output Format

Present exactly 3 posts, each labeled with its format and voice:

markdown
## Your 3 X Posts

**Voice:** [Selected voice name]
**Topic:** [User's topic]

---

### Post 1 — [Format Name]

[Full post text, ready to copy and paste]

---

### Post 2 — [Format Name]

[Full post text, ready to copy and paste]

---

### Post 3 — [Format Name]

[Full post text, ready to copy and paste]

Example:

markdown
## Your 3 X Posts

**Voice:** Alex Hormozi
**Topic:** Why most SaaS founders fail

---

### Post 1 — Comparison

SaaS founders who fail:

- Build for 6 months in silence
- Launch to crickets
- Blame the market

SaaS founders who win:

- Post the idea before writing code
- Get 50 people to say "I'd pay for that"
- Build only what was validated

The market doesn't lie. Your assumptions do.

---

### Post 2 — One-Liner

The graveyard of failed startups isn't full of bad ideas. It's full of founders who built before they sold.

---

### Post 3 — Stacked Progression

Day 1: "I have a great idea."
Week 2: "The MVP is almost done."
Month 3: "Just a few more features."
Month 6: "Why is no one signing up?"

You shipped a product. You never shipped distribution.

References

These files MUST be read using the Read tool before generating any posts (see Step 1):

FilePurpose
./references/formats.md8 proven post formats with structure templates, psychology, and rules
./references/posts.md51+ proven viral posts organized by format — the example library
./references/voices.md7 creator voice profiles (Hormozi, Naval, Gazdecki, Dakota, Machina, Ognjen, Dan Koe) with writing DNA and example posts

Why all three matter: Formats provide structural templates for how posts are built. Posts show those templates executed at the highest level with real examples. Voices add the human layer that makes content feel authentic instead of AI-generated. All three together = posts that go viral because they have proven structure + proven patterns + authentic voice.


Quality Checklist (Self-Verification)

Before finalizing output, verify ALL of the following:

Pre-Execution Check
  • I read ./references/formats.md before generating posts
  • I read ./references/posts.md before generating posts
  • I read ./references/voices.md before generating posts
  • I have all formats, example posts, and voice profiles in context
Format Verification
  • Each post uses a DIFFERENT format from formats.md (no repeats)
  • Each post follows its format's structure template exactly
  • Format-specific rules are followed (line counts, structure requirements)
Voice Verification
  • All 3 posts match the selected voice's sentence structure and rhythm
  • Posts sound like the voice — structurally matched, not copied
  • No phrases or examples were directly lifted from voice example posts
Content Verification
  • All 3 posts are about the user's specific topic (not generic filler)
  • Each post contains specific details, numbers, or examples (nothing vague)
  • No hashtags, engagement bait, or unnecessary emojis
  • Every post is under 280 characters OR clearly structured as a thread
  • Each post is ready to copy-paste and post immediately
The Screenshot Test
  • Would someone screenshot Post 1 and share it? If no → rewrite
  • Would someone screenshot Post 2 and share it? If no → rewrite
  • Would someone screenshot Post 3 and share it? If no → rewrite

If ANY check fails → revise before presenting.


Defaults & Assumptions

Use these unless the user overrides:

  • Number of posts: 3 (each in a different format)
  • Voice: Ask user to choose (auto-suggest based on topic and FOUNDER_CONTEXT.md)
  • Goal: Maximize engagement (likes, reposts, bookmarks)
  • Audience: Founders, entrepreneurs, builders (unless FOUNDER_CONTEXT specifies otherwise)
  • Tone: Matches selected voice profile
  • Post type: Single post (not thread) unless the topic requires more depth
  • Character limit: 280 characters per post (X standard)
  • Topic specificity: Use the user's exact topic — never drift to generic startup advice

Document any assumptions made in the output.

© ognjengt, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files (references) in skills/x-writer of ognjengt/founder-skills.

  • SKILL.md
  • references/formats.md
  • references/posts.md
  • references/voices.md

Open the folder on GitHubat commit a45931c

Compare with similar skills

X Writer next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

X Writer compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
X Writer this skillognjengt/founder-skills447—~3kAutomated safety check: PassMIT
Voice Buildercharlie947/social-media-skills3.8k—~3.3kAutomated safety check: PassMIT
Content Writerchrispangg/deepagentsdk128—~3.3kAutomated safety check: PassMIT
Import X Historypc-style/x-md159—~1.6kAutomated safety check: PassMIT
Write Like Meng On Xnirholas/three.ws2291 repos~2kAutomated safety check: PassApache-2.0
Draft In Voicegarrytan/gbrain31k—~3.7kAutomated safety check: PassMIT

Similar skills

  • Voice Builder

    charlie947/social-media-skills

    Build a personalised voice profile inside a Codex or Claude project from a short interview plus 3 to 5 sample pieces of writing.

    3.8k GitHub stars~3.3k tokensUpdated 25 days ago
    Writing & ContentAuto-check passed
  • Content Writer

    chrispangg/deepagentsdk

    Writing content across different platforms and styles. An agent skill from chrispangg/deepagentsdk.

    128 GitHub stars~3.3k tokensUpdated 7 mo ago
    Writing & ContentAuto-check passed
  • Import X History

    pc-style/x-md

    Imports an X (Twitter) account's post history in bulk through x.pcstyle.dev: hundreds to thousands of posts in one request, replies and reposts included, JSON or NDJSON, with per-account archiving…

    159 GitHub stars~1.6k tokensUpdated today
    Writing & ContentAuto-check passed
  • Write Like Meng On X

    nirholas/three.ws

    Write, rewrite, review, or continuously refine X/Twitter posts in Meng To's current voice using his deduplicated authored-post corpus, personal and product context, shared resources, and Content…

    229 GitHub starsUsed in 1 repo~2k tokens
    Writing & ContentAuto-check passed
  • Draft In Voice

    garrytan/gbrain

    Ghostwrite content in a specific person's voice from a VALIDATED voice profile — tweets, replies, short posts, launch copy, recruiting blurbs, emails.

    31k GitHub stars~3.7k tokensUpdated today
    Writing & ContentAuto-check passed
  • Felo Twitter Writer

    Felo-Inc/felo-skills

    Dual-mode Twitter/X writing tool. An agent skill from Felo-Inc/felo-skills.

    249 GitHub stars~6k tokensUpdated 2 mo ago
    Writing & ContentAuto-check passed

More from ognjengt/founder-skills

All 15 skills in this repo
  • Brand Copywriter

    ognjengt/founder-skills

    Writes marketing copy using proven copywriting frameworks. An agent skill from ognjengt/founder-skills.

    447 GitHub stars~3.2k tokensUpdated 4 mo ago
    Auto-check passed
  • Cro Optimization

    ognjengt/founder-skills

    Analyzes landing pages and provides detailed CRO (Conversion Rate Optimization) recommendations.

    447 GitHub stars~2.4k tokensUpdated 4 mo ago
    Auto-check passed
  • Lead Magnet Generator

    ognjengt/founder-skills

    Creates viral lead magnet posts that drive comments and DMs.

    447 GitHub stars~3k tokensUpdated 4 mo ago
    Auto-check passed
  • Linkedin Writer

    ognjengt/founder-skills

    Creates viral LinkedIn posts using proven formats, post templates, and voice matching.

    447 GitHub stars~3.4k tokensUpdated 4 mo ago
    Auto-check passed
  • Marketing Ideas

    ognjengt/founder-skills

    Produces the best marketing ideas for your business by analyzing your FOUNDERCONTEXT and matching it against a curated database of 170+ proven marketing strategies.

    447 GitHub stars~3.1k tokensUpdated 4 mo ago
    Auto-check passed
  • Outreach Specialist

    ognjengt/founder-skills

    Crafts high-converting outreach messages and email sequences for cold outreach, LinkedIn DMs, and follow-ups.

    447 GitHub stars~3.2k tokensUpdated 4 mo ago
    Auto-check passed

Works with

Questions about X Writer

What does X Writer do?

Creates viral X (Twitter) posts using proven formats, post templates, and creator voice matching. X Writer is an agent skill from ognjengt/founder-skills. Creates viral X (Twitter) posts using proven formats, post templates, and creator voice matching.

When should I use X Writer?

X Writer fits situations like: user needs engaging; high-performing posts for X/Twitter.

How do I install X Writer in Claude Code?

Run `npx skills add ognjengt/founder-skills --skill x-writer -a claude-code`. Or copy the skill folder (skills/x-writer in ognjengt/founder-skills) into .claude/skills/x-writer in your project. Claude Code loads it when a task matches its description.

How do I install X Writer in Codex?

Run `npx skills add ognjengt/founder-skills --skill x-writer -a codex`. Or copy the skill folder (skills/x-writer in ognjengt/founder-skills) into .agents/skills/x-writer in your project. Codex loads it when a task matches its description.

Can I use X Writer in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add ognjengt/founder-skills --skill x-writer -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/x-writer, .gemini/skills/x-writer, .github/skills/x-writer and .opencode/skills/x-writer in your project.

What does X Writer need to run?

SKILL.md names no scripts, command-line tools or credentials: X Writer is instructions for the agent only.

Does X Writer access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is X Writer safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does X Writer use?

X Writer is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does X Writer use?

About 3k tokens (SKILL.md is roughly 12k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 8.3k tokens, read only when the agent opens those files.

What are the alternatives to X Writer?

Skills that share tags, products or a category with X Writer: Voice Builder (charlie947/social-media-skills, 3.8k stars), Content Writer (chrispangg/deepagentsdk, 128 stars), Import X History (pc-style/x-md, 159 stars) and Write Like Meng On X (nirholas/three.ws, 229 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains X Writer?

ognjengt (a GitHub user) maintains it in ognjengt/founder-skills, which has 447 GitHub stars. The repository holds 15 skills in this directory. The repository was last updated on May 18, 2026.

Source: ognjengt/founder-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.