
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- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads writing-x-posts automatically when relevant.
- 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:
- Bold statement - Surprise, shock, or make a claim
- Tension - Highlight a struggle or pain point
- Twist - Flip expectations
- 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 examplesreferences/examples.md- Full thread and single post examples
Quick Checklist
- Does the hook stop the scroll?
- Is each tweet under 250 characters?
- Can each tweet stand alone?
- Is there a clear payoff for reading?
- Does it end with engagement opportunity?
- 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
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.
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).
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.
Popular docs & writing skills
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.
lark-markdown
open.feishu.cn
飞书 Markdown:查看、创建、上传、编辑和比较飞书中的原生 Markdown 文件。当用户要操作飞书 Markdown 文件,或比较其远端版本及本地草稿时使用。纯本地 Markdown 文件操作不触发本 skill。不负责将 Markdown 导入为飞书在线文档,也不负责文件搜索、权限、评论、移动、删除等云空间管理操作。
writing-beats
mattpocock/skills
Writing, exploit; assemble raw material into a journey of beats, grounding each term before a beat leans on it.
writing-shape
mattpocock/skills
Writing, exploit: shape raw material into an article, paragraph by paragraph.
writing-fragments
mattpocock/skills
Writing, explore: mine raw fragments, no structure yet.
writing-for-agents
mattpocock/skills
Writing documents for agents. Use when creating or editing skills, or modifying AGENTS.md or CLAUDE.md.