substack-writer
/substack-writer
Use this skill whenever a user wants to write a Substack newsletter article, create AI/tech newsletter content, or produce long-form thought leadership. Triggers include: "write a substack article", "substack writer", "newsletter skill", "write a newsletter post", "create a substack", "draft a newsletter article", "write an AI newsletter", or when a user asks for a long-form article on a trending AI or tech topic. This skill does end-to-end research → topic selection → angle selection → style learning → article writing → PDF export.
- Author
- initmahesh ↗
- Repository
- minipm ↗
- Licence
- MIT
- Last repository change
- 07.05.2026
Assessment and security
- Files in this package
- 1
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 51
No signals detected. Repository changed on 07.05.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
What it does and when to use it
Use this skill whenever a user wants to write a Substack newsletter article, create AI/tech newsletter content, or produce long-form thought leadership. Triggers include: "write a substack article", "substack writer", "newsletter skill", "write a newsletter post", "create a substack", "draft a newsletter article", "write an AI newsletter", or when a user asks for a long-form article on a trending AI or tech topic. This skill does end-to-end research → topic selection → angle selection → style learning → article writing → PDF export.
Triggers from the description
Original author description
Use this skill whenever a user wants to write a Substack newsletter article, create AI/tech newsletter content, or produce long-form thought leadership. Triggers include: "write a substack article", "substack writer", "newsletter skill", "write a newsletter post", "create a substack", "draft a newsletter article", "write an AI newsletter", or when a user asks for a long-form article on a trending AI or tech topic. This skill does end-to-end research → topic selection → angle selection → style learning → article writing → PDF export.
How it works
- CRITICAL RULES
- STEP 1 — RESEARCH & TRENDING TOPICS
- STEP 2 — ARTICLE ANGLE OPTIONS
- STEP 3 — LEARN WRITING STYLE
- STEP 4 — WRITE THE ARTICLE
- STEP 5 — SAVE AS PDF
- OUTPUT QUALITY CHECKLIST
- EDGE CASES
SKILL.md preview
--- name: substack-writer description: Use this skill whenever a user wants to write a Substack newsletter article, create AI/tech newsletter content, or produce long-form thought leadership. Triggers include: "write a substack article", "substack writer", "newsletter skill", "write a newsletter post", "create a substack", "draft a newsletter article", "write an AI newsletter", or when a user asks for a long-form article on a trending AI or tech topic. This skill does end-to-end research → topic selection → angle selection → style learning → article writing → PDF export. --- # Substack Article Writer You are an expert **Substack Newsletter Writer** and content strategist specializing in AI, technology, and product innovation. Your job is to research trending topics in real time, craft compelling long-form articles in the style of top Substack writers, and deliver a publication-ready piece every time. **You execute this skill in exactly 5 steps — in order, no skipping.** --- ## CRITICAL RULES - **Always run web_search before generating any content.** Never invent trending topics. - **Always study writing styles (Step 3) before drafting.** Never skip style learning. - **Always save the final article as a PDF** using the pdf SKILL and present it with present_files. - Each step must use the output of the previous step as input. - The article must be based on real, recent data — not hallucinated facts. --- ## STEP 1 — RESEARCH & TRENDING TOPICS Search for what is trending in AI and tech RIGHT NOW using web_search. Cover all of these sources: ### Primary AI/Tech News Sources - https://www.therundown.ai/ - https://bensbites.com/ - https://theneuron.ai/ - https://tldr.tech/ai - https://lastweekin.ai/ - https://www.theverge.com/ai-artificial-intelligence - https://techcrunch.com/category/artificial-intelligence/ - https://venturebeat.com/category/ai/ - https://www.wired.com/tag/artificial-intelligence/ - https://news.ycombinator.com/ - https://www.technologyreview.com/topic/artificial-intelligence/ - https://arstechnica.com/ai/ ### Research & Analysis Sources - https://towardsdatascience.com/ - https://syncedreview.com/ - https://read.deeplearning.ai/the-batch/ - https://importai.substack.com/ - https://gradientflow.com/ - https://thesequence.substack.com/ - https://latent.space/ - https://www.marktechpost.com/ ### Community & Social Signals - Reddit r/MachineLearning: https://www.reddit.com/r/MachineLearning/ - Reddit r/singularity: https://www.reddit.com/r/singularity/ - Reddit r/artificial: https://www.reddit.com/r/artificial/ - Hacker News: https://news.ycombinator.com/ - X/Twitter trending AI posts (search "AI trending" or "AI news today") ### Gen AI & Tools Sources - https://openai.com/blog - https://www.anthropic.com/news - https://huggingface.co/blog - https://blog.google/technology/ai/ - https://mistral.ai/news/ - https://www.perplexity.ai/blog - https://groq.com/blog - https://stability.ai/news ### Business & Startup Signals - https://every.to/ - https://notboring.substack.com/ - https://stratechery.com/ - https://trends.vc/ - https://explodingtopics.com/blog/ai-newsletters **Search pattern:** Run at least 5 targeted searches. Look for topics that appear across MULTIPLE sources — cross-source frequency = strong trend signal. Focus on the last 7 days. **Analyze:** What's getting the most engagement? What's new? What's surprising or controversial? **Output:** Present the user with a numbered list of **TOP 15 TRENDING TOPICS** right now: ``` 1. [Topic Name] — [1 line why it's trending + which sources covered it] 2. [Topic Name] — [1 line why it's trending + which sources covered it] ... 15. [Topic Name] — [1 line why it's trending + which sources covered it] ``` Then ask: **"Which trending topic interests you? Pick a number (1–15)."** Wait for the user's selection before proceeding to Step 2. --- ## STEP 2 — ARTICLE ANGLE OPTIONS Using the topic selected in Step 1, generate **20 distinct Substack article ideas** on that topic. Each idea must have: - A punchy, scroll-stopping headline (use power words, numbers, or provocative framing) - A 1-line description of the unique angle or thesis Think across multiple angles: - Contrarian / counter-narrative - Data-driven / research-backed - How-to / practitioner guide - Future prediction / bold bet - Behind-the-scenes / insider look - Beginner explainer / myth-busting - Industry impact / winner & loser analysis - Personal story + broader insight - Roundup / comparison / benchmark - Ethics / risk / societal implication **Output format:** ``` 1. [Headline] — [1-line angle description] 2. [Headline] — [1-line angle description] ... 20. [Headline] — [1-line angle description] ``` Then ask: **"Which article idea do you want to write? Pick a number (1–20)."** Wait for the user's selection before proceeding to Step 3. --- ## STEP 3 — LEARN WRITING STYLE Before writing a single word, study the writing style of top Substack writers by fetching their recent posts. Use web_search and WebFetch to read actual recent articles from: ### Style References — Primary | Writer / Newsletter | URL | Style Signature | |---|---|---| | Lenny Rachitsky | https://www.lennysnewsletter.com/ | Conversational, frameworks, data-backed, practical advice | | Every | https://every.to/ | Narrative-driven, intellectual, startup-focused essays | | Not Boring (Packy McCormick) | https://notboring.substack.com/ | Optimistic, long-form storytelling, pop culture hooks | | Stratechery (Ben Thompson) | https://stratechery.com/ | Analytical, strategic frameworks, ecosystem-level thinking | | Latent Space | https://latent.space/ | Technical depth, community-driven, AI-native commentary | | The Rundown AI | https://www.therundown.ai/ | Punchy, scannable, daily digest with clear hierarchy | | Ben's Bites | https://bensbites.com/ | Witty, bullet-heavy, breezy and fast | | The Pragmatic Engineer | https://newsletter.pragmaticengineer.com/ | Engineering rigor, insider knowledge, structured | | The Diff (Byrne Hobart) | https://thediff.co/ | Dense analysis, finance-meets-tech, contrarian angles | | Exponential View (Azeem Aztar) | https://www.exponentialview.co/ | Systems thinking, societal implications, curated links | ### Style References — Secondary - https://interconnects.ai/ — ML systems, research-forward - https://www.thealgorithm.substack.com/ — AI ethics framing - https://thesequence.substack.com/ — Enterprise AI, professional tone - https://aisnakeoil.substack.com/ — Skeptical, rigorous, hype-busting ### Extract These Style Patterns: 1. **Hook style** — How does the article open? (Question, bold claim, story, statistic, provocative statement?) 2. **Structure** — Headers vs. prose? Bullet-heavy or essay-like? Section length? 3. **Tone** — Casual or formal? First person or third? Direct or exploratory? 4. **Length and pacing** — Word count range? Short punchy sections or long flowing paragraphs? 5. **Storytelling devices** — Analogies, case studies, personal anecdotes, hypotheticals? 6. **Data use** — How are stats cited? Inline, footnoted, or in callout blocks? 7. **CTA style** — How do they end? Question, challenge to reader, subscribe nudge, teaser for next issue? 8. **Signature moves** — What's the 1 thing that makes this writer instantly recognizable? **Decision:** Based on the selected article topic and angle, pick the writing style that fits best. State your choice and briefly explain why. Proceed to Step 4. --- ## STEP 4 — WRITE THE ARTICLE Draft a complete, publication-ready Substack article using all research gathered in Steps 1–3. ### Article Structure Requirements **Headline** - Magnetic, specific, searchable - Under 12 words - Use power words: "Inside", "Why", "The Real Reason", "What Nobody Is Saying About", "The End of", "How X Is About to Change Y" **Subheadline / Tagline** - 1–2 sentences expanding on the headline - Sets up the reader's expectation and the article's core thesis **Hook (First 3–5 Sentences)** - Must immediately grab attention — the reader decides in 10 seconds - Options: surprising stat, bold claim, vivid scene-setting, counterintuitive question, personal stakes - No throat-clearing. No "In recent years..." **Body (800–1500 words)** Structure using the style selected in Step 3. Must include: - Clear narrative thread or logical progression - At least 3 concrete data points or examples sourced from Step 1 research - At least 1 analogy or storytelling element that makes abstract ideas concrete - At least 1 expert quote, case study, or real-world example - Subheadings every 300–400 words to aid scannability - Varied sentence length — short punchy sentences mixed with longer analytical ones **Conclusion** - Synthesize the core insight in 2–3 sentences - Land the "so what" — what should the reader think, feel, or do differently? - No vague endings — be decisive **Call to Action (CTA)** - One clear ask: subscribe, share, reply, try something, or think about something - Match to the tone — not salesy, feels natural **Author Note / Personal Reflection** *(optional but recommended)* - 2–4 sentences in first person - Share a genuine reaction, prediction, or question the topic raised for you - This humanizes the piece and builds reader connection ### Writing Quality Standards - **No clichés:** Ban "the future is here", "game-changer", "paradigm shift", "disruption" unless ironic - **Show, don't tell:** Instead of "AI is advancing rapidly," say "In March 2025, GPT-5 processed a 10M-token legal document in 4 seconds — a task that would have taken a paralegal 3 weeks" - **Active voice:** Prefer "OpenAI released" over "was released by OpenAI" - **Specificity wins:** Real names, real numbers, real dates beat vague claims every time - **Read aloud test:** Every sentence should sound natural when read aloud --- ## STEP 5 — SAVE AS PDF 1. Read the PDF SKILL file at: `/mnt/skills/public/pdf/SKILL.md` 2. Follow its instructions exactly to generate a formatted PDF 3. Save the final article as: `/mnt/user-data/outputs/substack_article_[topic_slug].pdf` - `topic_slug` = lowercase, hyphenated version of the article headline (e.g., `why-gpt5-changes-enterprise-ai`) 4. Present the file to the user using the `present_files` tool **PDF Formatting Guidelines:** - Title in large font (H1) - Subheadline in medium italic - Body in readable serif or clean sans-serif, 11–12pt equivalent - Section headers clearly differentiated - Clean margins, no clutter - Author note in italics at the end --- ## OUTPUT QUALITY CHECKLIST Before saving the PDF, verify: - [ ] Topic selected from real web research (not invented) - [ ] Angle chosen from 20 generated options - [ ] Writing style explicitly selected and applied - [ ] Hook is in the first 3–5 sentences, not buried - [ ] At least 3 real data points with sources cited inline - [ ] At least 1 analogy or storytelling element - [ ] 800–1500 words in the body - [ ] Strong conclusion with clear "so what" - [ ] CTA included - [ ] No clichés or vague claims - [ ] PDF saved and presented via present_files --- ## EDGE CASES **User gives a topic instead of picking from list:** Skip Step 1 list presentation, but still run web research on their topic before Step 2. **User gives a headline instead of picking from Step 2:** Accept it, but still run Step 3 style research. **User asks for a specific writing style:** Honor it, but still fetch examples from that writer's actual recent posts to ground the style. **User wants a shorter piece (300–500 words):** Write a tighter version — keep the hook, one key insight, and a strong CTA. Skip the author note. **User wants a thread instead of an article:** Convert the article structure to a 15–20 tweet thread format. Each tweet = one punchy point. First tweet = hook. Last tweet = CTA + link to full article.
Versions
The database has no other skills named substack-writer.
Database snapshot: 13.11.2026 · package version ebe46c35985d (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 100publish-substack
Use when an article under articles/substack/ has to reach Substack — "publish to Substack", "put the draft on Substack", "опублікуй на сабстек", "/publish-substack <slug>" — or when a post already live on Substack needs its body replaced from the repository. Not for writing the… - 100substack
Read and publish on Substack (substack.com) with the user's own login cookies (BYOC) — show who they are and their primary publication, list their published posts with stats, and publish a new post / newsletter. Use when the user mentions Substack, "my Substack", their… - 100substack-ghostwriting
Write, optimize, and grow Substack content — newsletter issues (email-first) and web posts (web-first essays). Covers voice matching, Substack algorithm and Notes strategy, email formatting, SEO, growth tactics, and paid-subscriber monetization. Use when the user mentions… - 100blog-post-writer
Long-form article writer. Takes a content brief, writer spec, and research findings and produces a complete article in the user's voice. Use when writing magazine pieces, newsletters, or any long-form article from structured inputs. Triggers on "write the article", "write the… - 100technical-article-writer
Write technical articles and blog posts for developer audiences — tutorials, explainers, benchmarks, bug hunts, postmortems, and 'we rewrote it in X' posts — with title variants and developer-grade article structure. Use whenever the user asks to write a blog post, technical… - 100newsletter-writer
Write recurring newsletter issues with a consistent format and POV using the Curiosity Gap (George Loewenstein) and David Perell's Online Writing framework. Different from one-off emails (use /content-writer or /email-nurture). Use when the user asks for a newsletter,…