MCPInstall

writing-x-posts

Create engaging X (Twitter) posts and threads that drive engagement and grow audience. Use this skill when asked to write X/Twitter content, create threads, craft viral tweets, or help with X engagement strategy. Triggers include requests for tweets, X posts, Twitter threads, or social media content for X.

Installs
139
Last 24h
—
Trending rank
—
Security
Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/jamesgray007/hoai-course --skill writing-x-posts
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads writing-x-posts automatically when relevant.

  3. 03

    Review the result

    The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

Writing X Posts

Create engaging X (Twitter) posts and threads that capture attention, drive engagement, and grow your audience.

Core Principles

Brevity is Power

X rewards concise, punchy content. Every word must earn its place. If you can say it in fewer words, do it.

One Idea Per Tweet

Single tweets should contain one complete thought. Threads expand on ideas but each tweet should still stand alone.

Hook or Die

You have ~1 second to stop the scroll. The first line determines everything—engagement, reach, and whether anyone reads the rest.

Content Formats

Single Post

  • Length: Under 280 characters (under 200 is better)
  • Purpose: One sharp insight, observation, or take
  • Best for: Hot takes, quick tips, observations, quotes

Thread

  • Length: 5-10 tweets (7 is the sweet spot)
  • Purpose: Deep dives, stories, frameworks, lists
  • Structure: Each tweet stands alone but builds narrative
  • Best for: Tutorials, stories, breakdowns, listicles

Post Anatomy

The Hook (Tweet 1)

The hook has one job: make someone stop scrolling.

Hook formula:

  1. Bold statement - Surprise, shock, or make a claim
  2. Tension - Highlight a struggle or pain point
  3. Twist - Flip expectations
  4. Open loop - Tease what's coming

See references/hooks.md for detailed hook patterns with examples.

The Body (Tweets 2-6)

  • Keep each tweet under 250 characters
  • Use cliffhangers every 1-2 tweets
  • Add visual breaks every 3-4 tweets
  • White space and short sentences aid scanning

The Close (Final tweets)

  • Punchy lesson: Crystallize the main takeaway
  • Soft CTA: Invite engagement naturally
  • Final CTA: Direct ask (follow, repost, reply)

Thread Frameworks

Storytelling Framework

Best for: Personal experiences, case studies

1/ [Hook - outcome or surprising moment]
2/ [Set the scene - context]
3/ [The challenge/conflict]
4/ [The journey - what happened]
5/ [The turning point]
6/ [The lesson]
7/ [CTA - question or follow prompt]

Listicle Framework

Best for: Tips, tools, resources

1/ [Hook - promise of value]
2/ [Item 1 - with brief explanation]
3/ [Item 2]
4/ [Item 3]
5/ [Item 4]
6/ [Item 5]
7/ [Summary + CTA]

Problem-Solution Framework

Best for: Educational content, how-tos

1/ [Hook - the problem everyone faces]
2/ [Agitate - why it's painful]
3/ [Solution intro]
4/ [Step 1]
5/ [Step 2]
6/ [Step 3]
7/ [Results + CTA]

Contrarian Framework

Best for: Thought leadership, hot takes

1/ [Bold contrarian statement]
2/ [What everyone believes]
3/ [Why they're wrong]
4/ [Your counter-argument]
5/ [Evidence/experience]
6/ [The nuanced truth]
7/ [Engagement question]

Writing Guidelines

Tone

  • Conversational, not formal
  • Confident, not arrogant
  • Slightly provocative (when appropriate)
  • Authentic, not performative

Formatting

  • Short sentences
  • Generous white space
  • Line breaks for emphasis
  • 1-2 hashtags max (or none)
  • Emojis sparingly (if brand allows)

What to Avoid

  • Corporate speak
  • Excessive hashtags
  • Links in main tweet (reduces reach)
  • Asking for engagement without providing value
  • Walls of text

Engagement Mechanics

Algorithm Signals

  • Time-on-post (longer = better)
  • Quick engagement in first hour
  • Replies and quote tweets
  • Saves and shares

Best Posting Times

  • Tuesday-Thursday, 9-11am and 1-3pm EST
  • Consistency matters more than perfect timing
  • 2-3 quality threads per week beats daily mediocrity

References

  • references/hooks.md - Detailed hook patterns with examples
  • references/examples.md - Full thread and single post examples

Quick Checklist

  1. Does the hook stop the scroll?
  2. Is each tweet under 250 characters?
  3. Can each tweet stand alone?
  4. Is there a clear payoff for reading?
  5. Does it end with engagement opportunity?
  6. Zero corporate speak?

FAQ

What does the writing-x-posts skill do?

Create engaging X (Twitter) posts and threads that drive engagement and grow audience. Use this skill when asked to write X/Twitter content, create threads, craft viral tweets, or help with X engagement strategy. Triggers include requests for tweets, X posts, Twitter threads, or social media content for X.

How do I install writing-x-posts?

Run npx skills add https://github.com/jamesgray007/hoai-course --skill writing-x-posts in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/writing-x-posts/ (personal) or .claude/skills/writing-x-posts/ (project).

Which AI agents can use writing-x-posts?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is writing-x-posts safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains writing-x-posts?

It is published by jamesgray007 in jamesgray007/hoai-course. It has 139 recorded installs.

More from jamesgray007/hoai-course

View all →

writing-linkedin-posts

jamesgray007/hoai-course

Create engaging, authentic LinkedIn posts like a Top Voice. Use this skill when asked to write LinkedIn content, social media posts for LinkedIn, professional thought leadership content, or help with LinkedIn engagement strategy. Triggers include requests for LinkedIn posts, professional social content, thought leadership pieces, or viral/engaging LinkedIn content.

Marketing & SEO648 installs

researching-ai-news

jamesgray007/hoai-course

Research and compile the latest AI news from across the industry. Use this skill when asked to find AI news, get AI updates, research what's happening in AI, check for AI announcements, or gather intelligence on AI companies. Triggers include requests for "AI news", "latest AI developments", "what's new in AI", "AI industry updates", or news about specific AI companies (OpenAI, Anthropic, Google, Microsoft, Meta, Amazon, Nvidia, xAI, Mistral, Cohere, Apple, Salesforce).

AI & Agents202 installs

writing-substack

jamesgray007/hoai-course

Create engaging Substack Notes that build community and grow subscribers. Use this skill when asked to write Substack Notes, short-form content for Substack, or help with Substack growth strategy. Triggers include requests for Substack Notes, Note ideas, or Substack engagement content.

Docs & Writing41 installs

Popular docs & writing skills

View category →

grill-with-docs

mattpocock/skills

A relentless interview to sharpen a plan or design, which also creates docs (ADR's and glossary) as we go.

Docs & Writing1.2M installs

lark-markdown

open.feishu.cn

飞书 Markdown:查看、创建、上传、编辑和比较飞书中的原生 Markdown 文件。当用户要操作飞书 Markdown 文件,或比较其远端版本及本地草稿时使用。纯本地 Markdown 文件操作不触发本 skill。不负责将 Markdown 导入为飞书在线文档,也不负责文件搜索、权限、评论、移动、删除等云空间管理操作。

Docs & Writing778.7K installs

writing-beats

mattpocock/skills

Writing, exploit; assemble raw material into a journey of beats, grounding each term before a beat leans on it.

Docs & Writing490.7K installs

writing-shape

mattpocock/skills

Writing, exploit: shape raw material into an article, paragraph by paragraph.

Docs & Writing490.2K installs

writing-fragments

mattpocock/skills

Writing, explore: mine raw fragments, no structure yet.

Docs & Writing489.6K installs

writing-for-agents

mattpocock/skills

Writing documents for agents. Use when creating or editing skills, or modifying AGENTS.md or CLAUDE.md.

Docs & Writing479.3K installs