Autopunk Media Skills

npm Skills Agents Quality Eval License GitHub stars

400+ free AI skills and 9 multi-step agents for media professionals — for Claude, ChatGPT, or any assistant. TV producers, journalists, podcasters, YouTubers, radio producers, newsletter writers, PR teams, screenwriters — every skill quality-tested. No coding required.

⭐ If this saves you time, star the repo — it helps other media professionals find it.

Jump to your role: Documentary Producer · Journalist · Data Journalist · YouTube Creator · Podcaster · Screenwriter · Newsletter Writer

---

What is this?

A free collection of 400+ AI skills and 9 multi-step agents — ready-to-use prompts that turn a capable assistant into a specialist for one specific media production task at a time.

Each skill encodes real production knowledge: the format conventions, the quality bar, the specific inputs a professional would know to provide. The output reads like it came from someone who has worked in the medium — not from a generic chatbot.

402 skills across 21 categories, plus 50 localized variants (DE/ES/FR/IT/PT) and 9 agents — all stable — that chain skills into complete workflows. Every skill is quality-scored on a seven-dimension G-Eval rubric — library mean 4.38/5, with 4.0 the minimum to ship. MIT licensed.

Each skill is a plain markdown file written in model-neutral language, so it works as a copy-paste prompt in Claude, ChatGPT, or any AI assistant — and the files drop straight into coding agents like Claude Code, Cursor, Codex CLI, and Gemini CLI. → Using the skills with OpenAI

---

Who is this for?

TV documentary producers · magazine journalists · YouTube creators · podcast producers · screenwriters · data journalists · radio producers · newsletter writers · PR professionals · researchers · social media managers · visual content creators · editors and production teams.

I work in…	Start here
📺 TV Documentary	Documentary Producer guide
📰 Journalism	Magazine Journalist guide
📊 Data Journalism	Data Journalist guide
📹 YouTube	YouTube Creator guide
🎙️ Podcasting	Podcaster guide
🎬 Screenwriting	Screenwriter guide
✉️ Newsletters	Newsletter Writer guide

---

What does it produce?

Three real outputs, unedited, from stable skills in the library:

YouTube hook — hook-generator — Input: video about why immersion fails for adult language learners

"94% of adult language learners plateau within six months. Not because they quit. Because they're doing the one thing every expert recommends — and it is actively working against how the adult brain acquires language. The science on this is twenty years old. Nobody taught it to you."

Documentary logline — logline-creator — Input: feature doc about forensic archivists recovering destroyed government records

"In a basement lab outside Washington, three archivists race to recover government records that were officially destroyed — before the statute of limitations runs out on the people who ordered the erasure."

Press release opening — press-kit-generator — Input: 6-part nature doc series, three continents, PBS-adjacent tone

"Seven years in production. Forty-two filming locations across three continents. One question that ornithologists have debated for a century: where do they actually go?"

That is the quality level across the library. Production-ready. Usable without editing.

---

How people use it

Role	Workflow	Skills used
Investigative reporter	FOIA request → document analysis → fact-check → publishable draft	Investigative Reporter Agent (7 skills)
YouTube creator	SEO title → hook → full script → thumbnail brief → description	YouTube Channel Operator Agent (8 skills)
Managing editor	AI policy → beat setup → editorial calendar → ethics review	Newsroom Operations Agent (5 skills)
Podcast producer	Guest research → interview questions → ad reads → show notes	Podcast Producer Agent (6 skills)
Data journalist	Find the story → clean data → statistics → chart descriptions → methodology	Data Journalism Investigator Agent (7 skills)
Documentary filmmaker	One-line idea → logline → treatment → series bible → broadcaster pitch	Documentary Development Agent (5 skills)

Each agent chains multiple skills into a single pipeline — paste the agent file, provide your brief, and get a complete deliverable. Or use individual skills one at a time.

---

Get started

You don't write the prompt — the skill is the prompt, already written. You paste it and add your topic. Works in Claude, ChatGPT, or any AI assistant — free accounts are fine.

Copy and paste (no technical setup needed):

1. Browse the skills/ folder — click any folder to open it, then click the skill file
2. Read the "What You Need To Provide" section so you know what to include
3. Copy the skill text and paste it into your assistant with your own material

That's the whole process. Here's an example input for hook-generator:

Topic: why most adults fail to learn a language — and why "immersion" advice is wrong.
Format: YouTube long-form. Audience: frustrated adult learners, 28–45. Tone: direct, science-backed.

Other install options:

Method	Command	Best for
Claude Code plugin	/plugin marketplace add ur-grue/autopunk-media-skills	Claude Code users
MCP server	cd mcp-server && npm install — setup guide	Cursor, VS Code, Windsurf, Zed
npm	npx autopunk-media-skills install --all	Any project
Git clone	git clone https://github.com/ur-grue/autopunk-media-skills.git	Cursor, Codex CLI, Gemini CLI
OpenAI	Copy-paste or build a Custom GPT — full guide	ChatGPT users

MCP integration: The included MCP server exposes every skill and agent as native tools — browse, search, and retrieve skills directly from Cursor, VS Code, Windsurf, Zed, or any MCP client. See mcp-server/README.md for setup.

Add a skill path to your project's CLAUDE.md or agent config so it loads automatically whenever you work in that project.

---

What's in the library

Category	Skills	What it covers
Research	73 skills	people · background · fact-checking · academic · data & statistics · competitive · logistics
Writing	57 skills	articles · broadcast · digital & social · institutional
Magazine Journalism	43 skills	ideation · writing · editing · investigation · fact-checking · legal · distribution
TV Documentary	27 skills	development · pre-production · scripting · post-production · localization · business
Media Business	18 skills	pitching · distribution · funding · legal
YouTube	18 skills	pre-production · scripting · post-production · channel strategy · business · analytics
Data Journalism	18 skills	analysis · investigation · visualization · publishing
Production Support	16 skills	formatting · reference
Editing	17 skills	line, structure & voice editing · project workflows
PR / Communications	13 skills	press office · crisis comms · media relations · content
Newsletter	13 skills	writing · strategy · growth · monetization
Podcast	12 skills	pre-production · scripting · post-production · business
Radio / Audio	12 skills	scripting · news packages · production · strategy
Social Media	11 skills	content · strategy
Pre-Production	10 skills	planning, scheduling & shoot briefs
Image Prompting	10 skills	Midjourney · Flux · art direction · workflows
Screenwriting	9 skills	development · scripting · revision · production
Translation	7 skills	text · institutional · digital · reference · quality
Archive & Legal	7 skills	archive research · rights & clearances
Audience & Distribution	7 skills	audience growth · publishing
Translation & Localization	4 skills	localization · cultural adaptation
Total	402 skills	+ 50 localized DE/ES/FR/IT/PT variants

Browse the full library in the skills/ folder. Skills are organized by media format, then by production stage.

---

Agents

Agents compose multiple skills into multi-step workflows that produce complete deliverables. Where a skill handles one task, an agent orchestrates a full pipeline — from brief to finished package.

Agent	What it produces	Skills composed	Status
Documentary Development	Complete development package from a one-line idea	logline-creator → pitch-treatment-writer → series-bible-generator → broadcaster-pitch-writer → festival-synopsis-writer	✅ stable (4.81/5)
Investigative Reporter	Investigation from spark to publishable draft	story-angle-finder → source-research-brief → foia-request-writer → document-analysis-summary → claim-verification-checklist → libel-check-brief → lede-writer	✅ stable (4.96/5)
Magazine Editor	End-to-end editing pass on a submitted draft	structure-checker → copy-editor-assistant → fact-check-prompt → house-style-enforcer → headline-generator → pull-quote-selector → ai-writing-detox	✅ stable (4.96/5)
YouTube Channel Operator	Full video pipeline from topic to publish-ready package	niche-video-idea-generator → seo-title-optimizer → hook-generator → full-script-writer → b-roll-shot-list → thumbnail-concept-brief → description-seo-writer → chapter-timestamps	✅ stable (4.48/5)
Podcast Producer	Episode end-to-end	episode-concept-generator → guest-research-brief → interview-question-builder → ad-read-script → show-notes-generator → episode-summary-writer	✅ stable (4.78/5)
PR Crisis Response	Crisis response package	holding-statement-writer → crisis-statement-writer → faq-document-writer → journalist-pitch-email → spokesperson-briefing-note	✅ stable (4.56/5)
Data Journalism Investigator	Complete data investigation package from dataset to publishable findings	data-story-finder → scraper-brief → data-cleaning-brief → basic-statistics-calculator → statistics-explainer → chart-description-writer → methodology-explainer	✅ stable (4.72/5)
Newsletter Launch	Full launch package from concept to signup page	niche-positioning-brief → edition-writer → subject-line-writer → welcome-email-writer → landing-page-copy-writer	✅ stable (4.68/5)
Newsroom Operations	Complete newsroom setup: policy, beats, calendar, arcs, ethics	newsroom-ai-policy → editorial-calendar-planner → beat-setup-guide → ethics-review-checklist → content-arc-planner	✅ stable (4.58/5)

Each agent operates in two modes: PLANNING (reads your brief, presents a step-by-step plan for approval) and EXECUTION (runs the approved plan, assembles the outputs into a single deliverable). You can interrupt between steps to adjust direction.

---

Workflows

Most real projects use multiple skills in sequence. These workflows walk you through an entire project from start to finish.

Workflow	Skills	Who it's for
YouTube Video Launch	8 skills	YouTube creators
Investigative Journalism Project	10 skills	Investigative reporters
Podcast Season Launch	9 skills	Podcast producers
Documentary Pitch to Greenlight	8 skills	Documentary filmmakers
Newsletter From Scratch	8 skills	Newsletter writers
PR Crisis Response	6 skills	PR professionals

---

Hooks

Hooks are write-time editorial guardrails. They run automatically while you work and surface non-blocking warnings when your text has common quality gaps — AI-flavoured language, missing attribution, unarchived URLs, or excessive passive voice.

Hooks advise. They never block your work or revert your edits.

Hook	Fires on	What it catches
ai-slop-detector	Every edit	Banned words, throat-clearing intros, "not just X — Y" constructions
attribution-check	Every edit	Quotes, statistics, or claims without a named source
archive-on-cite-reminder	Every edit	URLs added without an archive confirmation
passive-voice-warning	Every edit	Passive voice frequency above 25% (configurable)
pre-publish-checklist	Session end	6-item editorial checklist before you push

---

Quality

Every skill carries a quality score in its metadata. The library mean is 4.38/5, and 4.0 is the minimum to ship.

Badge	Status	What it means
🔲 planned	Coming soon	On the roadmap but not written yet
🟡 draft	Written, not tested	Do not use in production
🔵 beta	Tested at least once	Usable — may have rough edges
✅ stable	Scored ≥ 4.0/5 on quality eval	Safe to use without supervision

Only skills that pass a seven-dimension quality evaluation earn stable status. The evaluation tests coherence, consistency, fluency, relevance, professionalism, actionability, and editorial naturalness — scored against a rubric aligned to real media industry standards. See tests/EVAL_FRAMEWORK.md for the full process.

Our assertion suite ran 226 skills against binary checks using diverse inputs (standard, minimal, European context): 2,354 / 2,390 checks passed (98.5%). All 36 misses occurred on deliberately minimal inputs where skills correctly refused to fabricate content — the desired professional behavior. No skill failed on a well-specified input.

Full results: tests/EVAL_RESULTS.md · Methodology: tests/README.md

---

Guides

Guide	What it does
Getting Started	Pick your role, get 3 starter skills, start producing
Writing Better Inputs	How to brief the assistant so output is usable on the first try
Skill Index	Find any skill by what you need to do — not by category
Troubleshooting	Output not right? Common fixes for common problems
Roadmap	What's done, in progress, and planned next

---

Contributing

Got an idea for a skill? Found one that gave bad output? Want to improve an existing skill?

See CONTRIBUTING.md — there's a plain-English section at the top written for non-developers.

Short version:

1. Open a GitHub Issue describing the skill you want
2. The concept is reviewed and approved
3. The skill is written using SKILL_TEMPLATE.md
4. It goes through quality testing before it's marked stable

---

Related projects

This repo exists within a growing ecosystem of agent skills for media, journalism, writing, and marketing. We maintain a curated list of 25+ related projects — peers, infrastructure, and inspiration.

→ Full list with annotations

---

License

MIT — free to use, fork, and adapt. See LICENSE.

---

Maintained by Autopunk — AI workflows for media producers.

Want to contribute? See CONTRIBUTING.md. Found a bug? Open an issue.