| name | substack-expert |
| description | This skill should be used when creating, formatting, or optimizing content for a Substack newsletter. Covers post structure, SEO metadata (titles, slugs, meta descriptions), native engagement features (Notes, Polls, Chat), monetization tactics, and free-to-paid conversion strategies. |
| metadata | {"author":"ft.ia.br","version":"1.1","date":"2026-03-05T00:00:00.000Z","repository":"https://github.com/fabricioctelles/skills","license":"Apache 2.0","category":"library-and-api-reference"} |
Substack Expert
Parameters
| Parameter | Description | Default |
|---|
topic | Subject or draft content to work with | Infer from the conversation |
goal | Primary objective: format, seo, growth, monetize | format + seo if unspecified |
language | Output language | Match the user's message language |
Workflow
1. Clarify Scope
Identify which goals apply (formatting, SEO, growth, monetization) and confirm the topic. If the request is ambiguous, default to producing SEO metadata and a formatted structure outline simultaneously.
2. Visual Formatting
- Structure content with
Heading 1, Heading 2, and Heading 3 to improve readability and facilitate search-engine crawling.
- Apply the centering and styling techniques described in
references/formatting-best-practices.md.
- Insert native engagement tools (Subscribe button, polls, Leave a comment) at natural breakpoints in the post.
3. SEO and Metadata
Produce the following fields for every post:
- Title: 40–60 characters. Use clear modifiers, keywords, and authority signals (e.g., "Tested", "Complete Guide"). Avoid vague or clickbait phrasing.
- URL Slug: 3–5 main keywords only, no auto-generated numbers, no dates (keeps the post evergreen). Example:
/substack-seo-strategy.
- Meta Description: 155–160 characters, includes the primary keyword and an implicit call to action.
- Image Alt Text: Describe the image for accessibility; incorporate article keywords organically.
Consult references/seo-output-example.md for a worked example.
4. Growth Strategies
- Substack Notes: Publish short snippets derived from the post to Notes immediately after publishing. Leave authentic comments on related publications to build name recognition.
- Recommendations rotation: Review Analytics monthly to identify which partner newsletters drive inbound traffic. Rotate recommended partners every 30–60 days to maintain reciprocal growth.
5. Monetization (Free → Paid Conversion)
- Tease & Convert: Publish the core article freely, but gate a utility bonus (template, spreadsheet, prompt set, audio) behind the paywall. Prove value before asking for payment.
- VIP outreach: In the Dashboard, filter subscribers by engagement score (4–5 stars), then send a targeted direct message offering a special rate or exclusive invite to the paid tier.
- Welcome email: Customize the automated welcome email to introduce the author, set publishing cadence expectations, and link to the three best existing articles. Never leave the platform default.
- Homepage taxonomy: Group posts into Tags (equivalent to newspaper sections) and add them to the navigation bar via Website Themes for advanced content discovery.
Quality Checklist
Before delivering output, verify:
