Skip to content
cccskills
FreePublished on GitHub

substack-expert

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.

The English summary is being prepared. Showing the original description.

See how to install

Files included (3)

  • SKILL.md4.1 KB
  • references/formatting-best-practices.md1.8 KB
  • references/seo-output-example.md1.4 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Substack Expert

Parameters

ParameterDescriptionDefault
topicSubject or draft content to work withInfer from the conversation
goalPrimary objective: format, seo, growth, monetizeformat + seo if unspecified
languageOutput languageMatch 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.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Audit, score, and compare repositories containing portable Agent Plugins against the official Agent Plugins specification. Use when asked to review a plugin repo, check plugin.json or mcp.json conformance, assess bundled skills and MCP servers, produce an evidence-cited 0–100 plugin scorecard, identify release blockers, or compare two agent plugins side by side.

The English summary is being prepared. Showing the original description.

fabricioctelles/skills114Updated Oct 19, 2026

Sub-skill de agent-ready-cloudflare: Implement A2A Agent Card

The English summary is being prepared. Showing the original description.

fabricioctelles/skills114Updated Oct 19, 2026

Sub-skill de agent-ready-cloudflare: Implement ACP Discovery Document

The English summary is being prepared. Showing the original description.

fabricioctelles/skills114Updated Oct 19, 2026

Sub-skill de agent-ready-cloudflare: Implement Agent Skills Discovery Index

The English summary is being prepared. Showing the original description.

fabricioctelles/skills114Updated Oct 19, 2026

Sub-skill de agent-ready-cloudflare: Implement AI Bot Rules in robots.txt

The English summary is being prepared. Showing the original description.

fabricioctelles/skills114Updated Oct 19, 2026

Sub-skill de agent-ready-cloudflare: Implement API Catalog

The English summary is being prepared. Showing the original description.

fabricioctelles/skills114Updated Oct 19, 2026

See all skills by fabricioctelles

Report a problem with this skill