writing-substack

Generate hook-driven Substack Notes within a 500-character limit.

12|4|Updated Mar 14, 2026
One-click install
npx skills add https://github.com/mshadmanrahman/pm-pilot --skill writing-substack
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-substack
Source: https://github.com/mshadmanrahman/pm-pilot/tree/main/skills/content/writing-substack
Command: npx skills add https://github.com/mshadmanrahman/pm-pilot --skill writing-substack

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Quickly craft platform-optimized Substack Notes that fit the 500-character limit while maximizing engagement and clarity, removing guesswork around hooks, structure, and hashtags.

Core Features & Use Cases

  • Hook-first format: Produces a bold, attention-grabbing first line that delivers on its promise.
  • Concise structure: Generates 1–3 short paragraphs, a clear CTA, and suggests 2–4 relevant hashtags.
  • Use Case: Turn a topic or idea into a ready-to-post Substack Note for newsletters, audience growth experiments, or social cross-posting.

Quick Start

Write a 400-character Substack Note about "product management lessons" with a strong hook, two brief paragraphs, a CTA, and three suggested hashtags.

Frequently Asked Questions about writing-substack

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I write a Substack Note that fits the 500-character limit?

To write a Substack Note under 500 characters, use a hook-first format with 1–3 short paragraphs, a CTA, and 2–4 hashtags. This ensures concise, engaging content that strictly satisfies platform character counting constraints.

What is the best structure for Substack Notes to maximize audience growth?

The best structure for Substack Notes relies on a bold, attention-grabbing hook followed by 1–3 brief paragraphs and a clear CTA. This one-idea-per-note format maximizes clarity and engagement for audience growth experiments.

Can I generate social snippets from long-form newsletter posts for Substack?

Yes, you can generate social snippets from long-form newsletter posts by distilling the topic into a single idea. The output produces an attention-grabbing hook, concise paragraphs, and suggested hashtags optimized for Substack Notes.

Does every Substack Note need a hook and hashtags?

Every Substack Note requires a hook and hashtags to maximize engagement. The hook delivers an attention-grabbing first line, while 2–4 suggested hashtags improve discoverability for thought-leader threads and cross-posting.

Why do my Substack Notes exceed the 500-character platform constraint?

Substack Notes exceed the 500-character constraint when lacking strict character counting during drafting. Using a conversational voice with a one-idea-per-note constraint ensures the hook, paragraphs, CTA, and hashtags fit accurately.