
Writing Substack
- 40 installs
- 20 repo stars
- Updated December 19, 2025
- jamesgray007/hoai-course
Writes engaging Substack Notes and short-form content designed to build community and grow subscribers.
About
Generates Substack Notes and short-form content plus growth-oriented ideas aimed at engagement and subscriber growth. A creator uses it when they need Note ideas or community-building content for Substack.
- Focused on Substack Notes and short-form engagement content
- Ties content to subscriber-growth and community strategy
Writing Substack by the numbers
- 40 all-time installs (skills.sh)
- Ranked #582 of 853 Sales & Marketing skills by installs in the Skillselion catalog
- Data as of Aug 2, 2026 (Skillselion catalog sync)
npx skills add https://github.com/jamesgray007/hoai-course --skill writing-substackAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 40 |
|---|---|
| repo stars | ★ 20 |
| Last updated | December 19, 2025 |
| Repository | jamesgray007/hoai-course ↗ |
What it does
Writes engaging Substack Notes and short-form content designed to build community and grow subscribers.
Files
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 Notesreferences/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?
Substack Notes Examples
Full Note examples demonstrating best practices for different formats.
Table of Contents
- Short Wisdom Notes
- Micro-Story Notes
- Question/Invitation Notes
- Contrarian Notes
- Behind-the-Scenes Notes
- Restack with Commentary
---
Short Wisdom Notes
One insight in 1-3 lines. ~30-50 words.
Example 1
The best career advice I ever got:
"Stop trying to be interesting. Start being interested."
Took me a decade to actually understand what that meant.Why it works: Personal attribution, quotable insight, vulnerability in the last line.
---
Example 2
Most advice is autobiography disguised as universal truth.
The person telling you "the right way" is usually just telling you what worked for them.
Doesn't mean it'll work for you.Why it works: Reframe that makes reader reconsider how they consume advice.
---
Example 3
Productivity isn't about doing more.
It's about knowing what not to do.
The hard part isn't adding things to your life. It's removing them.Why it works: Contrarian take on popular topic, builds to a clear point.
---
Micro-Story Notes
Brief anecdote building to one insight. ~80-150 words.
Example 1
Someone asked me yesterday what I'd do differently if I could start my career over.
I said: "I'd stop asking for permission."
Not permission from bosses. Permission from myself.
I spent years waiting until I felt "ready." Until I had the right credentials. Until someone told me I could.
Turns out, nobody was going to give me that permission. The people who seemed to have it? They just decided to start.
What are you waiting for permission to do?Why it works: Opens with specific moment, builds to universal insight, ends with engaging question.
---
Example 2
I almost sent an angry email last night.
I'd written it, re-read it three times, and had my cursor hovering over send.
Then I closed my laptop and went to bed instead.
This morning I read it again. Deleted the whole thing.
The version I would have sent was technically "right." But it would have made everything worse.
Sometimes the most powerful thing you can do is nothing.Why it works: Relatable scenario, tension, universal lesson that readers can apply.
---
Example 3
My mentor told me something ten years ago that I completely dismissed.
"You're not as important as you think you are."
I was offended. I thought she was putting me down.
Now I understand what she meant:
Nobody's paying as much attention to your failures as you are. Nobody's tracking your mistakes. You're not the main character in anyone else's story.
That's actually the most freeing thing I've ever learned.Why it works: Story arc with twist, insight that reframes what seemed negative.
---
Question/Invitation Notes
Genuine questions that spark conversation. ~30-60 words.
Example 1
Honest question I've been sitting with:
How do you know when to quit something vs. when to push through?
I've made both mistakes—quit too early, stayed too long.
Still don't have a good framework for this. What's worked for you?Why it works: Admits uncertainty, invites real responses, not rhetorical.
---
Example 2
What's something you believed strongly 5 years ago that you've completely changed your mind about?
I'll go first: I used to think working more hours = more output.
Now I know that's completely backwards.
What about you?Why it works: Goes first with own answer, makes it easy for others to respond.
---
Example 3
I'm curious—what's a piece of "common wisdom" in your field that you think is actually wrong?
Every industry has these. Rules that everyone follows but nobody questions.
What's yours?Why it works: Industry-specific but universally applicable, invites expertise sharing.
---
Contrarian Notes
Challenge conventional wisdom. ~50-100 words.
Example 1
Unpopular opinion:
"Follow your passion" is advice that mostly works for privileged people.
If you have bills to pay and mouths to feed, "passion" is a luxury.
Better advice: Get good at something valuable. Passion often follows mastery.
You don't have to love your work to build a good life.Why it works: Directly challenges popular advice, offers alternative, acknowledges nuance.
---
Example 2
Hot take: Most networking is a waste of time.
Collecting business cards from strangers you'll never talk to again isn't networking.
Real networking:
- Help people without expecting anything back
- Stay in touch with 10 people who matter
- Be known for one thing
Depth > breadth.Why it works: Bold opening, specific alternative, actionable reframe.
---
Example 3
What if "imposter syndrome" isn't a syndrome at all?
What if it's just... accurate self-assessment?
Maybe feeling like you don't know everything is the correct response to being in a room full of smart people.
Maybe the people who never feel like imposters are the ones we should worry about.Why it works: Reframes a common struggle, makes reader feel seen rather than broken.
---
Behind-the-Scenes Notes
Share your process or creative journey. ~60-100 words.
Example 1
Sharing something I don't usually talk about:
My first 20 posts got almost zero engagement.
I almost quit after post #15. Felt like I was shouting into a void.
Post #23 was the first one that actually connected.
If you're early and feeling invisible: that's normal. The people who make it look easy just started before you did.
Keep going.Why it works: Vulnerable, specific numbers, encouragement for others in same position.
---
Example 2
Behind the scenes of today's newsletter:
Draft 1: Too long, deleted half
Draft 2: Too short, felt incomplete
Draft 3: Realized I was trying to say two things at once
Draft 4: Cut to one idea, finally worked
Writing looks effortless when you only see the final version.
It's not.Why it works: Shows messy reality, makes others feel normal about their own struggles.
---
Example 3
Something I'm working through right now:
I keep saying yes to things I should say no to.
Not because I want to do them. Because I'm afraid of disappointing people.
I don't have a solution yet. Just noticing the pattern.
Anyone else deal with this?Why it works: Real-time vulnerability, invites community support, no false resolution.
---
Restack with Commentary
Share others' content with your perspective. ~30-50 words of your own.
Example 1
[Restacking someone's Note about writing daily]
This resonates.
I used to think I needed inspiration to write. Now I know writing creates the inspiration.
The muse shows up after you start, not before.Why it works: Adds personal experience to someone else's insight, extends the conversation.
---
Example 2
[Restacking someone's Note about career pivots]
Made a similar pivot three years ago.
Best decision I ever made—but it didn't feel that way at the time. It felt terrifying.
If you're considering a change and it scares you, that might be a good sign.Why it works: Personal proof point, encouragement for others considering same move.
---
Formatting Reminders
Across all examples, notice:
- Short paragraphs: 1-2 sentences max
- White space: Line breaks between thoughts
- Word count: Most are under 100 words
- First line: Hooks immediately, no throat-clearing
- Last line: Often a question or invitation
- Tone: Conversational, honest, human
- No hashtags: Notes don't use them
Substack Notes Hooks
Opening patterns that stop the scroll and spark conversation.
Table of Contents
---
Story Openers
Start in the middle of a moment. Most viral Notes open with story, not advice.
Pattern: [Specific moment or scene that drops reader into action]
Examples:
- "I was halfway through my coffee when it hit me."
- "Someone asked me a question yesterday that I can't stop thinking about."
- "I almost deleted this before posting."
- "Three years ago, I would have disagreed with what I'm about to say."
- "My mentor told me something that made no sense at the time."
Why it works: Story creates immediate emotional engagement. Readers want to know what happens.
---
Observation Hooks
Share something you've noticed. Fresh perspective on everyday experiences.
Pattern: [I've noticed/I realized/Something I've been thinking about] + [specific observation]
Examples:
- "I've noticed that the most productive people I know rarely talk about productivity."
- "Something I've been thinking about: the best conversations happen when nobody's trying to be impressive."
- "A pattern I keep seeing: people wait for permission they don't actually need."
- "The older I get, the more I realize that most advice is autobiography."
- "I've started paying attention to what makes me feel energized vs. depleted."
Why it works: Observations feel genuine and invite others to share their own.
---
Contrarian Hooks
Challenge what everyone believes. These get 3-4x more engagement than standard advice.
Pattern: [Popular belief/common advice] + [why you disagree or see it differently]
Examples:
- "Hot take: 'follow your passion' is advice that only works if you're already privileged."
- "Unpopular opinion: networking events are mostly useless."
- "I'm starting to think hustle culture isn't the problem. Lack of direction is."
- "What if 'imposter syndrome' is just accurate self-assessment?"
- "Maybe the goal isn't to be more productive. Maybe it's to need less."
Why it works: Challenges create cognitive tension. Readers need to engage to resolve it.
---
Question Hooks
Genuine questions that invite real responses. Not rhetorical—actually curious.
Pattern: [Question you're genuinely wrestling with]
Examples:
- "Honest question: how do you know when to quit vs. when to push through?"
- "I'm curious—what's a belief you held strongly 5 years ago that you've completely changed?"
- "What's something you wish someone had told you earlier in your career?"
- "How do you balance ambition with contentment?"
- "When's the last time you changed your mind about something important?"
Why it works: Questions invite participation. People love sharing their perspective.
---
Confession Hooks
Admit something vulnerable or counterintuitive. Authenticity builds trust.
Pattern: [Honest admission that goes against your "brand" or expected persona]
Examples:
- "I'll be honest: I don't have this figured out."
- "Something I don't talk about much: I almost quit last year."
- "Confession: I give advice I don't always follow myself."
- "I used to think I needed to have all the answers. I don't."
- "Here's what I got wrong about [topic]."
Why it works: Vulnerability stands out in a sea of polished content. People connect with honesty.
---
Reframe Hooks
Take a familiar concept and present it differently.
Pattern: [Common understanding] → [New way to see it]
Examples:
- "Procrastination isn't laziness. It's fear wearing a different mask."
- "Maybe writer's block isn't a block. Maybe it's your brain asking for more input."
- "What if 'being stuck' is just the feeling of growth before it becomes visible?"
- "Burnout isn't about working too hard. It's about working on the wrong things."
- "Rejection isn't failure. It's information."
Why it works: Reframes make people see familiar things differently. That's valuable.
---
Hooks to Avoid
Generic advice openers:
- ❌ "Here are 5 tips for..."
- ❌ "Want to be more productive? Try this..."
- ❌ "The secret to success is..."
Bot-like patterns:
- ❌ "In today's fast-paced world..."
- ❌ "As a [professional], I..."
- ❌ "Let me share some insights about..."
Engagement bait without substance:
- ❌ "Agree or disagree?"
- ❌ "Comment below if..."
- ❌ "Who else feels this way?"
---
Hook Testing
Before posting, ask:
1. Would I stop scrolling for this? 2. Does it sound like a real person? 3. Is there something to respond to? 4. Am I starting with story/observation, not advice? 5. Would I want to read what comes after this?
Weak: "Here's what I've learned about productivity." Strong: "I used to wake up at 5am every day. Then I realized I was just running from something."