aiskilloftheweek/substack-note-generator
Generate optimized Substack Notes starting from long-form content.
npx skills add https://github.com/aiskilloftheweek/claude-ai-skill-of-the-week --skill substack-note-generatorname: substack-notes
description: Generate high-performing Substack notes using proven structural patterns and psychology while maintaining your authentic voice. Use when user wants to write Substack notes, mentions "write a note", "Substack post", or needs short-form social content for Substack.
This skill generates high-performing Substack notes by applying proven structural patterns and psychological techniques while maintaining YOUR unique voice.
Critical distinction: This skill uses STRUCTURAL PATTERNS and PSYCHOLOGY (not tone) that have been proven to work, expressed in YOUR authentic voice.
Use this skill when:
Analyze the input and select the best note type:
1. Single-Punch Wisdom - One powerful quotable statement (1-2 sentences)
2. Income Proof Story - Share results with vulnerable beginning (3-7 sentences)
3. Pattern Observation - "I've noticed..." authority-building insight (3-8 sentences)
4. Contrarian Statement - Challenge conventional wisdom (2-6 sentences)
5. Problem → Solution Insight - Identify issue + root cause + fix (3-6 sentences)
6. Build-in-Public Update - Transparent progress sharing (3-8 sentences)
7. List-Based Tactical - Actionable numbered/bulleted advice (4-12 sentences)
8. Vulnerable Personal Story - Deep connection through story (4-10 sentences)
9. Philosophical Observation - Life principle or worldview (2-5 sentences)
10. Direct Advice - Clear instruction with reasoning (2-5 sentences)
If user is unsure, recommend based on their goal:
Each note type has a proven formula. Apply the structure while using the user's voice.
[One powerful statement that stands alone]
[Optional: Brief supporting thought]
Psychology: Screenshot-worthy, highly shareable
Length: 1-2 sentences
[Starting point - vulnerability or struggle]
[Turning point - what changed]
[Results - specific numbers]
[Insight or encouragement for reader]
Psychology: Builds credibility through transparency
Length: 3-7 sentences
[Hook: "I've noticed..." or "A pattern I see..."]
[Examples or numbered list of patterns]
[Why it matters or application]
Psychology: Creates authority through observation
Length: 3-8 sentences
[Bold claim that contradicts common belief]
[Why conventional thinking is wrong]
[Better alternative or truth]
Psychology: Creates cognitive dissonance, memorable
Length: 2-6 sentences
["You don't have X because..."]
[Root cause explanation]
[What to do instead]
Psychology: "Aha moments" through revealing hidden causes
Length: 3-6 sentences
[What you're working on]
[Specific metrics/progress]
[Learning, insight, or next step]
Psychology: Transparency builds trust and connection
Length: 3-8 sentences
[Hook: "How to X:" or "If you want Y:"]
- [Specific action 1]
- [Specific action 2]
- [Specific action 3]
[Optional: Punchy closing insight]
Psychology: High perceived value, scannable, actionable
Length: 4-12 sentences
[Personal moment or realization]
[Emotional impact or turning point]
[Universal lesson or takeaway]
Psychology: Deep connection through humanization
Length: 4-10 sentences
[Core principle or belief]
[Supporting explanation]
[Implication for reader]
Psychology: Establishes worldview, attracts aligned audience
Length: 2-5 sentences
[Imperative: "Do this" or "Stop doing that"]
[Why it matters]
[What happens if you follow/ignore]
Psychology: Clear guidance, removes ambiguity
Length: 2-5 sentences
Critical Requirements:
Structure Application Checklist:
Formatting Guidelines:
What to Include:
What to Avoid:
Authority Building:
Connection Building:
Engagement Tactics:
Ultra-Short (1-2 sentences): Maximum shareability, quotable wisdom
Short (3-5 sentences): Quick insight with context - MOST COMMON
Medium (6-10 sentences): Teaching or storytelling
Long (10+ sentences): Deep dives, comprehensive frameworks - RARE
Default to 3-5 sentences unless the message demands more.
User Request: "I want to share what I've noticed about successful problem solvers"
Generated Note:
A pattern I've noticed in people who solve hard problems:
They don't start by googling solutions.
They sit with the problem. Write it down. Break it apart. Ask better questions.
Only then do they look for answers.
Most people skip straight to searching for solutions to problems they haven't fully understood.
User Request: "Share progress on my new content system"
Generated Note:
Week 3 of building my content system:
Created 15 pieces this week. Took 6 hours total (used to take 20).
The secret: Templates + voice documentation + clear frameworks.
Still refining the process, but already seeing how this scales.
The system pays for itself in time savings.
User Request: "Explain why people can't focus"
Generated Note:
You can't focus because you don't have a priority.
When everything feels important, nothing is important. Your brain doesn't know what to lock onto.
Solution: Pick ONE thing. Make everything else wait.
Clarity creates focus.
User Request: "Share my freelancing journey results"
Generated Note:
My first 6 months freelancing: $0
Month 7: First client, $500 project
Month 12: $3K/month consistent
Month 18: $8K/month, booked out 3 months ahead
It didn't click overnight. But once it clicked, everything moved fast.
User Request: "Challenge the 'hustle culture' mindset"
Generated Note:
You don't need to hustle harder.
You need to sleep better, eat cleaner, and stress less.
Everyone's optimizing for more output. Nobody's optimizing for better inputs.
Your energy determines your results more than your effort.
1. Vague Generalities
❌ "Success takes time and hard work"
✅ "My first 6 months: $0. Month 7: $10K. Nothing happens, then everything happens."
2. Humble-Bragging
❌ "So grateful for this little win" [shows huge number]
✅ "Made $50K this month. Here's the mistake that cost me $30K of it."
3. Clickbait Without Payoff
❌ "This one thing changed everything" [no specifics]
✅ "Switched from hourly to value pricing. Doubled my income in 8 weeks."
4. Generic Advice
❌ "Work hard and believe in yourself"
✅ "Wake up at 5am. Complete your hardest task first. Ignore everything else until noon."
5. Corporate Voice
❌ "We're excited to announce our new offering"
✅ "Built something new. Tested it for 3 weeks. It works. Here's what it does."
Before delivering the note, verify:
Structural Integrity:
Value Delivery:
Engagement Potential:
Formatting:
Remember: This skill gives you proven structures and psychology that work on Substack.
The result: High-performing Substack notes that sound authentically like you while using patterns that drive engagement, build authority, and create connection.
Take aiskilloftheweek/substack-note-generator from the repository into ~/.claude/skills for personal
use, or into .claude/skills inside a project.
The agent identifies a skill by the name field in its header. Two skills with the
same name cannot sit side by side — one of them will be ignored.