Substack agent skills

7 free, MIT-licensed skills that turn Claude Code, Codex, Cursor or any skills-compatible agent into a Substack writing partner. They write Notes, outline newsletter issues from your own material, find titles people open and audit why a publication isn't growing. Your agent's own model runs them: no API keys, no accounts, nothing phones home. They draft; you publish on Substack.

npx skills add liftli-ai/substack-agent-skills

Or as a Claude Code plugin:

/plugin marketplace add liftli-ai/substack-agent-skills
/plugin install substack-agent-skills@liftli-substack

● MIT license · runs on your agent's model · github.com/liftli-ai/substack-agent-skills

Want a Substack plan that carries over between chats? Connect Liftli free (no card) or see Liftli for Substack. Useful? Star it on GitHub so others find it.

What these are

A skill is an installable instruction package: a SKILL.md your agent reads and runs with its own model. Installing one teaches your agent a Substack craft: Notes that stand on their own in the feed, an issue built on one structure instead of three, a subtitle that pays off the title instead of repeating it.

New here? Ask your agent "help me with my Substack". The substack-agent skill picks the right skill, and substack-voice builds a voice file from three of your own pieces so every draft sounds like you. It is the same voice file the LinkedIn agent skills read, so you build it once.

The skills write and check; they never post. Substack has no public API for publishing, so each skill ends with copy-ready text you paste into Substack. Install everything with the command above, or a single skill with --skill <name>. Every card below carries its exact command.

Start here The front door and your voice file

Start

substack-agent

Substack Agent

The front door to the kit: routes any Substack request to the right skill, sets up the voice file first, and suggests a weekly routine of one issue plus a few Notes.

npx skills add liftli-ai/substack-agent-skills --skill substack-agent
Start

substack-voice

Substack Voice File

Builds a voice file from three of the user's own pieces and four short questions. It is the same .liftli/voice.md the LinkedIn skills read, with a short section for how they sound in a newsletter.

npx skills add liftli-ai/substack-agent-skills --skill substack-voice

Write Notes, issue outlines, titles and repurposing

Write

substack-notes-writer

Substack Notes Writer

Five Substack Notes of different types (teach, behind the scenes, question, shift, proof, invite), each with one goal, a first line that earns the stop, and no link-dumping.

npx skills add liftli-ai/substack-agent-skills --skill substack-notes-writer
Write

substack-issue-outliner

Substack Issue Outliner

Picks one of five newsletter issue structures, maps the user's own material onto each section, and turns every gap into a question instead of inventing filler.

npx skills add liftli-ai/substack-agent-skills --skill substack-issue-outliner
Write

substack-subject-line-generator

Substack Subject Line Generator

8 labeled title and subtitle pairs that work as email subject line plus inbox preview, with character counts, the best two picked, and the reasons.

npx skills add liftli-ai/substack-agent-skills --skill substack-subject-line-generator
Write

linkedin-to-substack

LinkedIn to Substack

Turns a LinkedIn post into Substack Notes or a full newsletter issue section with room to argue the case. Strips the LinkedIn habits and keeps the user's facts exact.

npx skills add liftli-ai/substack-agent-skills --skill linkedin-to-substack

Grow Why the publication isn't growing, and the next fix

Grow

substack-growth-audit

Substack Growth Audit

A 20-point publication checklist: About page, welcome email, Recommendations, cadence, the Notes habit and outside distribution. Scored, with a short fix list ordered for the user's stage.

npx skills add liftli-ai/substack-agent-skills --skill substack-growth-audit

Skills vs. Liftli

Skills are stateless: your agent brings the model, the skill brings the craft. What they can't know is you: your publication's promise, your strategy, last month's material, which issues landed. That is Liftli for Substack. It connects to Claude or ChatGPT as one MCP URL, keeps a separate strategy for your Substack, drafts newsletter issues and Notes in your voice, and critiques each draft before you use it. It does not publish to Substack: you paste the draft and press publish. The Substack MCP page explains why, and compares the community servers that do post.

Substack agent skills on GitHub, compared

Few open-source Substack skill collections exist yet. Star counts are as of 14 October 2026.

RepositoryStarsWhat it coversPosts to Substack?
liftli-ai/substack-agent-skills (this page)new7 skills: a router, a voice file shared with the LinkedIn set, Notes, issue outlines, titles and subtitles, a 20-point growth audit, LinkedIn to Substack. MIT.No. Copy-ready text you paste.
Arin117Kaushik/substack-skills311 skills: Notes, posts with SEO packaging, repurposing, a humanizer, an interviewer, reply drafts, segment campaigns, About page audits, analytics recaps and a content planner. MIT.Yes, through a publisher skill that runs a local script with your Substack cookies, after an approval card.
liftli-ai/linkedin-agent-skillsnewThe LinkedIn sibling: 31 skills for posts, hooks, comments, profile audits and pre-publish checks, on the same voice file. MIT.Not Substack. LinkedIn through Liftli's official API connection, after you approve.

They are plain markdown files, so you can mix them. If you want your agent to post to Substack from chat, that takes an MCP server signed in with your session; see the Substack MCP comparison for what that involves.

Frequently asked questions

What is a Substack agent skill?

A Substack agent skill is a SKILL.md instruction package that teaches an AI agent such as Claude Code, Codex or Cursor one Substack job: writing Notes, outlining a newsletter issue, finding a title people open or auditing a publication. The agent's own model runs it, so there is no API key and nothing to connect. This page lists 7 of them, free and MIT-licensed.

Is there a Claude skill for Substack?

Yes. These 7 Substack agent skills install into Claude Code as a plugin (/plugin marketplace add liftli-ai/substack-agent-skills, then /plugin install substack-agent-skills@liftli-substack) or into any skills-compatible agent with npx skills add liftli-ai/substack-agent-skills. They write Notes, outline issues from your own material, write titles and subtitles, and audit why a publication isn't growing.

Can Claude post to Substack?

Not with these skills. Substack has no public API for publishing posts or Notes, so every skill ends with copy-ready text you paste into Substack and publish yourself. Some community Substack MCP servers can post by using your logged-in session cookie; the Substack MCP page on liftli.ai compares them and their trade-offs.

Which Substack skill should I start with?

Start with substack-agent: it reads your request and picks the right skill. Build your voice file with substack-voice first, because every writing skill reads it. For a single job, install just that skill, for example substack-notes-writer for Notes or substack-growth-audit if your publication has stalled.

Do these work with the LinkedIn agent skills?

Yes. Both sets read the same voice file (.liftli/voice.md), so you build it once. The linkedin-to-substack skill turns a LinkedIn post into Substack Notes or an issue section, and the 31 LinkedIn agent skills live at github.com/liftli-ai/linkedin-agent-skills.

Are the skills really free?

Yes. They are MIT-licensed and run entirely on your agent's own model. Liftli never sees your content and pays nothing per use, so there is nothing to meter. They are the single-job versions of what Liftli does as a full strategist.

How do the skills differ from Liftli?

Skills are stateless: your agent brings the model, the skill brings the craft, and each chat starts from zero apart from your voice file. Liftli is an MCP connector that keeps your Substack strategy and voice between sessions, drafts newsletter issues and Notes from your real material, and critiques each draft. It does not publish to Substack: you paste the draft into Substack and publish it there.

Your agent knows the craft. Liftli knows your newsletter.

A Substack strategy that carries over between chats, issues and Notes drafted from your real week, and a critique before you publish. You paste and press publish.

Start free, no card