
writing-substack
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.
- Installs
- 41
- 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-substack- 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-substack 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 Substack Notes
Create engaging Substack Notes that spark genuine conversations, build community, and grow your subscriber base.
What Are Notes?
Notes are Substack's short-form content format—similar to tweets but without character limits. They appear in the Notes feed and are designed for discovery, engagement, and community building.
Key differences from newsletters:
- No subject lines (not delivered via email)
- Shorter format (50-150 words optimal)
- Discoverable in the Notes feed
- Algorithm rewards genuine engagement
- Content can surface for days/weeks (unlike Twitter)
Core Principles
Community First
Engage with others' Notes before posting your own. Substack Notes rewards genuine community participation, not broadcasting.
Conversation Over Content
Notes that spark discussion outperform polished content. Ask questions. Invite responses. Be curious.
Story Over Advice
Notes that open with story moments get 3x more engagement than those opening with advice or tips.
Authenticity Over Perfection
The algorithm surfaces genuine voices, not polished performances. Sound human, not like a bot.
Optimal Note Structure
Length
- Sweet spot: 50-100 words (~87 words average for viral Notes)
- Maximum: 300 words for micro-stories
- 3-5 sentences is often enough
Formatting
- Short paragraphs (1-2 sentences)
- Line breaks between thoughts
- Make the main point jump out immediately
- White space aids scanning
Note Formats
Short Wisdom
One insight delivered in 1-3 lines. Like a quote or proverb.
Best for: Quick observations, reframings, aha moments
Micro-Story
A brief anecdote (under 300 words) building to a single insight. Often starts in the middle of the action.
Best for: Personal experiences, lessons learned
List/Countdown
Bullet points or numbered lines centered on a theme.
Best for: Quick tips, observations, curated ideas
Question/Invitation
Open-ended question that invites community response.
Best for: Sparking discussion, learning from audience
Behind-the-Scenes
Share your process, works in progress, or creative journey.
Best for: Building connection, showing authenticity
Restack with Commentary
Share someone else's Note or post with your perspective added.
Best for: Community building, adding value to conversations
See references/hooks.md for opening patterns and references/examples.md for full Note examples.
Writing Guidelines
Tone
- Conversational, not performative
- Honest, not polished
- Curious, not authoritative
- Personal, not generic
What Works
- Contrarian takes (3-4x more engagement than "helpful tips")
- Emotional resonance (make readers feel seen)
- Vulnerability and honesty
- Questions that invite real responses
- Story openings, not advice openings
What to Avoid
- Sounding like a bot or AI
- Generic advice without personal context
- Hot takes without substance
- Engagement bait without value
- Treating Notes like tweets or LinkedIn posts
Engagement Strategy
The First Hour Is Critical
- Notes with 10+ comments in the first hour are 5x more likely to go viral
- Respond to every comment in the first hour
- 5-10 genuine conversations can trigger algorithm amplification
Daily Rhythm (Optional)
- Morning: Community Note—invite participation, ask a question
- Midday: Educational Note—one clear insight with your take
- Evening: Reflective Note—honest thoughts, encouragement
Community Building
- Comment thoughtfully on other writers' Notes daily
- Restack content you genuinely value with added commentary
- Build relationships with 3-5 new writers weekly
- Support others consistently—they'll notice and reciprocate
Growth Mechanics
Algorithm Signals
- Early engagement matters more than follower count
- Genuine conversation > vanity metrics
- A Note from someone with 100 followers can outperform one with 10,000+
- Content can surface for days/weeks (unlike other platforms)
Subscriber Conversion
- Notes drive discovery → profile visits → newsletter subscriptions
- Every interaction nudges readers closer to subscribing
- Writers who subscribe often become recommenders
References
references/hooks.md- Opening patterns for Notesreferences/examples.md- Full Note examples by format
Quick Checklist
- Is this under 100 words? (Or under 300 for a micro-story?)
- Does it sound like me, not a bot?
- Would this spark a conversation?
- Am I opening with story/observation, not advice?
- Is there something for readers to respond to?
- Have I engaged with others' Notes today?
FAQ
What does the writing-substack skill do?
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.
How do I install writing-substack?
Run npx skills add https://github.com/jamesgray007/hoai-course --skill writing-substack 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-substack/ (personal) or .claude/skills/writing-substack/ (project).
Which AI agents can use writing-substack?
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-substack 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-substack?
It is published by jamesgray007 in jamesgray007/hoai-course. It has 41 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-x-posts
jamesgray007/hoai-course
Open the skill to read its SKILL.md instructions.
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.