# Writing Substack

> Platform-optimized Substack Notes creation. 500-char limit, hook-driven, engagement-focused. Triggers on: "write a Substack Note", "Substack content", "Note ideas".

- Skill: `mshadmanrahman/writing-substack` (Agent Skill)
- Install (CLI): `npx skillmds@latest add mshadmanrahman/writing-substack`
- Raw SKILL.md: https://api.skillmd.com/api/skills/mshadmanrahman/writing-substack/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: mshadmanrahman (https://skillmd.com/u/mshadmanrahman)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/mshadmanrahman/writing-substack

---


# 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.