SkillsAdd

fabricioctelles/skills

substack-expert

This skill should be used when creating, formatting, or optimizing content for a Substack newsletter.

First seen May 2, 2026

Installation

$ npx skills add fabricioctelles/skills --skill substack-expert
View on skills.sh ↗ GitHub repository ↗

Summary

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

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

stitch-design-taste Same topic
leonxlnx/taste-skill 287.7K installs
firecrawl-seo-audit Same topic
firecrawl/firecrawl-workflows

Audit a website's SEO with Firecrawl. Use when the user asks for an SEO audit, metadata and hea…

31.6K installs
taste-design Same topic
google-labs-code/stitch-skills 17.5K installs
apify-ultimate-scraper Same topic
apify/agent-skills

Universal AI-powered web scraper for any platform. Scrape data from Instagram, Facebook, TikTok…

15.2K installs
clerk-vue-patterns Same topic
clerk/skills

Vue 3 patterns with Clerk — composables (useAuth, useUser, useClerk, useOrganization), Vue Rout…

11.4K installs
email-best-practices Same topic
resend/resend-skills

Use when building email features, emails going to spam, high bounce rates, setting up SPF/DKIM/…

8.9K installs

Also in this package

Other skills from fabricioctelles/skills · top by installs.

npx skills add fabricioctelles/skills
okf-open-knowledge-format 281 humanizar 98 design-md-validator 90 ultimate-design-system-master 79 geo-optimization 62 revenue-centric-design 62 coolify-operator 61 resume-ats-beater 61 startup-idea 56 security-specialist 55

Browse all from fabricioctelles/skills

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 74
License LICENSE
Default branch main
Open issues 1
Status Active

Skill metadata

Parsed from SKILL.md frontmatter.

Version1.1
LicenseApache 2.0
More metadata
author
ft.ia.br
version
1.1
date
2026-03-05
repository
https://github.com/fabricioctelles/skills
license
Apache 2.0
category
library-and-api-reference

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 4,196 B
  • docs SUMMARY.md 307 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 59 installs

SKILL.md

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:

  • Title is 40–60 characters and contains the primary keyword.
  • URL slug has 3–5 words, no numbers, no dates.
  • Meta description is 155–160 characters with a keyword and implicit CTA.
  • All images have alt text.
  • Subject line (if applicable) is under 50 characters and free of spam triggers.
  • At least one native engagement element (button, poll, or comment prompt) is included.
  • Paywall placement follows the Tease & Convert model (not a mid-sentence cut).
  • Welcome email customization is recommended if the post is the first in a new publication.