MCPInstall

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
  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-substack 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 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)

  1. Morning: Community Note—invite participation, ask a question
  2. Midday: Educational Note—one clear insight with your take
  3. 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 Notes
  • references/examples.md - Full Note examples by format

Quick Checklist

  1. Is this under 100 words? (Or under 300 for a micro-story?)
  2. Does it sound like me, not a bot?
  3. Would this spark a conversation?
  4. Am I opening with story/observation, not advice?
  5. Is there something for readers to respond to?
  6. 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

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-x-posts

jamesgray007/hoai-course

Open the skill to read its SKILL.md instructions.

Docs & Writing138 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