Pm-pilot writing-substack

install
source · Clone the upstream repo
git clone https://github.com/mshadmanrahman/pm-pilot
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/mshadmanrahman/pm-pilot "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/content/writing-substack" ~/.claude/skills/mshadmanrahman-pm-pilot-writing-substack && rm -rf "$T"
manifest: skills/content/writing-substack/SKILL.md
source content

Writing Substack Notes

Create Substack Notes: short, punchy, engagement-optimized.

Trigger

"write a Substack Note", "Substack content", "Note ideas"

Format Constraints

  • Total length: Under 500 characters (Substack Notes limit).
  • Hook: First line grabs attention. Bold claim, surprising stat, or provocative question.
  • Body: 2-5 short paragraphs. One idea per paragraph. Conversational tone.
  • CTA: End with engagement driver (question, invitation, teaser).
  • Hashtags: 2-4 relevant hashtags suggested separately.

Process

  1. Confirm topic and angle with user.
  2. Load voice profile if configured (see writing-style skill).
  3. Draft Note within 500 char limit.
  4. Suggest 2-4 hashtags.
  5. Offer 1-2 alternate hooks if user wants options.

Output Format

{Hook line}

{Body paragraph 1}

{Body paragraph 2}

{CTA}

---
Suggested hashtags: #tag1 #tag2 #tag3
Character count: {n}/500

Examples

Topic: Product management lessons

Most PRDs are fiction.

They describe a world where scope never creeps, timelines hold, and stakeholders agree on day one.

The best PMs I know write living docs. Updated weekly. Contradictions included.

What does your PRD process actually look like?

---
Suggested hashtags: #ProductManagement #PRD #BuildingProducts
Character count: 312/500

Rules

  • Count characters accurately. Hard limit 500.
  • Conversational, not corporate. Write like talking to a smart friend.
  • One idea per Note. If there are multiple ideas, suggest a thread.
  • No clickbait. The hook should deliver on its promise.