Back to Skills

substack-ghostwriting

Write, optimize, and grow Substack content — both newsletter issues (email-first) and web posts (web-first articles/essays). Covers ghostwriting with voice matching, Substack algorithm optimization, Notes strategy, email formatting, SEO, growth tactics, and monetization planning. Use when the user mentions Substack, newsletters, write a newsletter issue, Substack post, Substack article, web post on Substack, evergreen content, SEO for Substack, newsletter growth, Notes strategy, ghostwrite for,

147stars10forksUpdated 6/26/2026

Security Assessment

Safe(100/100)
Security Score100/100

About substack-ghostwriting

substack-ghostwriting helps write, optimize, and grow Substack content across two formats — newsletter issues (email-first) and web posts (web-first articles and essays) — and two voice modes, the user's own voice or ghostwriting in someone else's. It covers voice matching, Substack algorithm optimization, Notes strategy, email formatting, SEO, growth tactics, and monetization planning. It triggers on Substack-related work, and also on general article or newsletter writing and adapting existing content (a blog post, talk, or thread) into newsletter or web-post form; it explicitly defers generic blog writing without a newsletter context to a separate technical-article-writer skill. It is user-invocable and can use web search and fetch.

The skill's philosophy is that Substack is a social-media-newsletter hybrid whose algorithm optimizes for subscriptions rather than engagement, since revenue comes from subscription cuts rather than ads — so genuine quality wins. For ghostwriting, the job is capturing a client's existing insights in their voice (clients are "insights-rich and time-poor," writers "time-rich but insights-poor"), making extraction and voice matching the core craft. It first detects two dimensions — voice (own vs ghostwriting) and format (newsletter issue vs web post) — and routes to reference files: platform-constraints, voice-matching, email-formatting, and web-post-formatting.

The workflow is deliberately gated on user input. Ghostwriting begins with a voice guide built from samples (transcripts preferred over writing over media), 10-15 voice markers with examples, validated with the user before drafting. The Writing Workflow then runs Phase 0 voice calibration (own-voice mode, ideally from an existing Substack URL), a mandatory Phase 1 intake interview covering topic, format, audience, objective, context, and length — with explicit instruction to stop and wait for answers — and Phase 2, which generates 5 title/subject-line variants and 3 distinct hook options for the user to pick or remix before any body is written. Title guidance favors specificity, a clear benefit, and 6-10 words; newsletters pair a subject line with complementary preview text, while web posts add a keyword-rich SEO title under 60 characters and an SEO description. Notes are framed as a cheap testing pipeline to validate topics before committing to long-form.

FAQ

What types of Substack content does this skill handle?

Two formats — newsletter issues (email-first) and web posts (web-first articles/essays) — in two voice modes: the user's own voice or ghostwriting in someone else's voice.

When should I not use this skill?

Do not use it for generic blog post writing without a newsletter or Substack context; the doc directs that case to the samber/cc-skills technical-article-writer skill instead.

How does it approach ghostwriting in someone else's voice?

It builds a voice guide from samples (transcripts preferred over writing over media), extracting 10-15 voice markers with examples, and validates that guide with you before any drafting begins.

Will it start writing immediately?

No. Phase 1 is a mandatory intake interview covering topic, format, audience, objective, context, and length, and the skill stops and waits for your answers. Phase 2 then offers 5 title variants and 3 hooks for you to pick or remix before the body is written.

How does it handle SEO for web posts versus newsletters?

Web posts use a separate keyword-rich SEO title (under 60 characters) plus an SEO description, while newsletter issues rely on a subject line paired with complementary preview text (the first ~90 characters) to drive open rate.

All Files

8 files
evals/evals.json13.3 KB
View
references/web-post-formatting.md8.0 KB
View
references/email-formatting.md5.6 KB
View
references/voice-matching.md6.2 KB
View
references/platform-constraints.md3.0 KB
View
references/substack-algorithm.md8.0 KB
View
references/social-distribution.md1.6 KB
View
SKILL.md15.3 KB
View

Install substack-ghostwriting

Download and extract the skill files to your .claude/skills/ directory.

Quick Setup:

  1. Copy the skill folder to .claude/skills/
  2. Claude will automatically detect and use the skill