substack-drafter

Convert Markdown or text to Tiptap JSON and create Substack drafts.

4|1|Updated Mar 14, 2026
One-click install
npx skills add https://github.com/MattVOLTA/outworkos_diy --skill substack-drafter
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: substack-drafter
Source: https://github.com/MattVOLTA/outworkos_diy/tree/main/skills/substack-drafter
Command: npx skills add https://github.com/MattVOLTA/outworkos_diy --skill substack-drafter

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Draft Substack posts by converting Markdown or text into Substack-ready drafts, enabling a safe draft-only workflow and automated content preparation.

Core Features & Use Cases

  • Convert Markdown or plain text to Substack-compatible Tiptap JSON and create drafts via the Substack API.
  • Authenticate through Chrome MCP browser tools to manage Substack sessions securely.
  • Use cases: preparing long-form notes, batch-drafting multiple articles, and ensuring drafts are created without publishing.

Quick Start

Provide a Markdown or text file and Substack publication URL, then run the draft workflow to create a new Substack draft.

Frequently Asked Questions about substack-drafter

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert Markdown to Substack drafts automatically?

You can convert Markdown to Substack drafts by transforming the content into Tiptap JSON and sending it to the Substack draft creation endpoint. This allows safe, automated draft creation without publishing.

Can I batch-draft multiple Substack articles from text files?

Yes, you can batch-draft multiple Substack articles by processing text or Markdown files sequentially. The workflow converts each file into Tiptap JSON and creates individual drafts, automating content preparation.

Do I need browser authentication to create Substack drafts via API?

Yes, browser authentication is required to create Substack drafts. The workflow uses Chrome MCP browser tools to manage Substack sessions securely, ensuring your draft creation endpoint requests are authenticated.

What is Tiptap JSON and why is it needed for Substack drafting?

Tiptap JSON is the structured content format required by the Substack draft creation endpoint. Converting your Markdown or plain text into this double-JSON body format ensures the draft content is properly rendered.

Will this Substack drafting workflow accidentally publish my posts?

No, this workflow operates as a draft-only process and will not publish your posts. It strictly creates drafts by sending converted content to the draft creation endpoint, ensuring a safe preparation environment.

Can I use plain text instead of Markdown for Substack draft creation?

Yes, you can use plain text instead of Markdown for Substack draft creation. The workflow accepts both formats as input and converts either into the required Tiptap JSON structure before creating the draft.