Sandbox
@ur-grue/autopunk-media-skills

Media skills library for Claude, Cursor, and MCP

This repo gives you ready-made skills and agents for common media tasks, from story ideas and research to scripts, briefs, and editorial review. The skills are plain markdown prompts, while the agents chain several skills into full workflows. It also ships with hooks for writing checks and an MCP server so assistants can browse and retrieve the library as tools.

30 stars1 forksPythonUpdated 17d ago
Who it's for

Builders who create journalism, podcast, video, newsletter, PR, or screenwriting work with an AI assistant.

What it delivers

You can turn a general assistant into a media-specific workflow with reusable prompts, agents, and checks.

What it does

400+ media skills

Individual markdown skills cover research, writing, editing, YouTube, podcasting, newsletters, PR, screenwriting, and more.

9 multi-step agents

Agents like Investigative Reporter, YouTube Channel Operator, and Podcast Producer chain skills into full deliverables.

Quality-tested library

Skills are scored and marked stable after evaluation, with results tracked in `tests/`.

Hooks for editorial checks

Hooks flag issues like AI-flavoured wording, missing attribution, unarchived URLs, and passive voice.

MCP server access

The `mcp-server/` package exposes skills and agents as tools for MCP clients.

Claude plugin packaging

The `.claude-plugin/` files let Claude Code users install the library as a plugin.

How to get it

  1. 1That'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.

README

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 DocumentaryDocumentary Producer guide
📰 JournalismMagazine Journalist guide
📊 Data JournalismData Journalist guide
📹 YouTubeYouTube Creator guide
🎙️ PodcastingPodcaster guide
🎬 ScreenwritingScreenwriter guide
✉️ NewslettersNewsletter Writer guide

What does it produce?

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

YouTube hookhook-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 loglinelogline-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 openingpress-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

RoleWorkflowSkills used
Investigative reporterFOIA request → document analysis → fact-check → publishable draftInvestigative Reporter Agent (7 skills)
YouTube creatorSEO title → hook → full script → thumbnail brief → descriptionYouTube Channel Operator Agent (8 skills)
Managing editorAI policy → beat setup → editorial calendar → ethics reviewNewsroom Operations Agent (5 skills)
Podcast producerGuest research → interview questions → ad reads → show notesPodcast Producer Agent (6 skills)
Data journalistFind the story → clean data → statistics → chart descriptions → methodologyData Journalism Investigator Agent (7 skills)
Documentary filmmakerOne-line idea → logline → treatment → series bible → broadcaster pitchDocumentary 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:

MethodCommandBest for
Claude Code plugin/plugin marketplace add ur-grue/autopunk-media-skillsClaude Code users
MCP servercd mcp-server && npm installsetup guideCursor, VS Code, Windsurf, Zed
npmnpx autopunk-media-skills install --allAny project
Git clonegit clone https://github.com/ur-grue/autopunk-media-skills.gitCursor, Codex CLI, Gemini CLI
OpenAICopy-paste or build a Custom GPT — full guideChatGPT 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

CategorySkillsWhat it covers
Research73 skillspeople · background · fact-checking · academic · data & statistics · competitive · logistics
Writing57 skillsarticles · broadcast · digital & social · institutional
Magazine Journalism43 skillsideation · writing · editing · investigation · fact-checking · legal · distribution
TV Documentary27 skillsdevelopment · pre-production · scripting · post-production · localization · business
Media Business18 skillspitching · distribution · funding · legal
YouTube18 skillspre-production · scripting · post-production · channel strategy · business · analytics
Data Journalism18 skillsanalysis · investigation · visualization · publishing
Production Support16 skillsformatting · reference
Editing17 skillsline, structure & voice editing · project workflows
PR / Communications13 skillspress office · crisis comms · media relations · content
Newsletter13 skillswriting · strategy · growth · monetization
Podcast12 skillspre-production · scripting · post-production · business
Radio / Audio12 skillsscripting · news packages · production · strategy
Social Media11 skillscontent · strategy
Pre-Production10 skillsplanning, scheduling & shoot briefs
Image Prompting10 skillsMidjourney · Flux · art direction · workflows
Screenwriting9 skillsdevelopment · scripting · revision · production
Translation7 skillstext · institutional · digital · reference · quality
Archive & Legal7 skillsarchive research · rights & clearances
Audience & Distribution7 skillsaudience growth · publishing
Translation & Localization4 skillslocalization · cultural adaptation
Total402 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.

AgentWhat it producesSkills composedStatus
Documentary DevelopmentComplete development package from a one-line idealogline-creator → pitch-treatment-writer → series-bible-generator → broadcaster-pitch-writer → festival-synopsis-writer✅ stable (4.81/5)
Investigative ReporterInvestigation from spark to publishable draftstory-angle-finder → source-research-brief → foia-request-writer → document-analysis-summary → claim-verification-checklist → libel-check-brief → lede-writer✅ stable (4.96/5)
Magazine EditorEnd-to-end editing pass on a submitted draftstructure-checker → copy-editor-assistant → fact-check-prompt → house-style-enforcer → headline-generator → pull-quote-selector → ai-writing-detox✅ stable (4.96/5)
YouTube Channel OperatorFull video pipeline from topic to publish-ready packageniche-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 ProducerEpisode end-to-endepisode-concept-generator → guest-research-brief → interview-question-builder → ad-read-script → show-notes-generator → episode-summary-writer✅ stable (4.78/5)
PR Crisis ResponseCrisis response packageholding-statement-writer → crisis-statement-writer → faq-document-writer → journalist-pitch-email → spokesperson-briefing-note✅ stable (4.56/5)
Data Journalism InvestigatorComplete data investigation package from dataset to publishable findingsdata-story-finder → scraper-brief → data-cleaning-brief → basic-statistics-calculator → statistics-explainer → chart-description-writer → methodology-explainer✅ stable (4.72/5)
Newsletter LaunchFull launch package from concept to signup pageniche-positioning-brief → edition-writer → subject-line-writer → welcome-email-writer → landing-page-copy-writer✅ stable (4.68/5)
Newsroom OperationsComplete newsroom setup: policy, beats, calendar, arcs, ethicsnewsroom-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.

WorkflowSkillsWho it's for
YouTube Video Launch8 skillsYouTube creators
Investigative Journalism Project10 skillsInvestigative reporters
Podcast Season Launch9 skillsPodcast producers
Documentary Pitch to Greenlight8 skillsDocumentary filmmakers
Newsletter From Scratch8 skillsNewsletter writers
PR Crisis Response6 skillsPR 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.

HookFires onWhat it catches
ai-slop-detectorEvery editBanned words, throat-clearing intros, "not just X — Y" constructions
attribution-checkEvery editQuotes, statistics, or claims without a named source
archive-on-cite-reminderEvery editURLs added without an archive confirmation
passive-voice-warningEvery editPassive voice frequency above 25% (configurable)
pre-publish-checklistSession end6-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.

BadgeStatusWhat it means
🔲 plannedComing soonOn the roadmap but not written yet
🟡 draftWritten, not testedDo not use in production
🔵 betaTested at least onceUsable — may have rough edges
stableScored ≥ 4.0/5 on quality evalSafe 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

GuideWhat it does
Getting StartedPick your role, get 3 starter skills, start producing
Writing Better InputsHow to brief the assistant so output is usable on the first try
Skill IndexFind any skill by what you need to do — not by category
TroubleshootingOutput not right? Common fixes for common problems
RoadmapWhat'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.

Files in the repo

Repository payload25 top-level entries
  • .claude
  • .claude-plugin
  • .github
  • .planning
  • agents
  • bin
  • content
  • docs
  • hooks
  • mcp-server
  • scripts
  • skills
  • tests
  • .gitattributes
  • .gitignore
  • CHANGELOG.md
  • CLAUDE.md
  • CONTRIBUTING.md
  • LICENSE
  • package.json
  • README.md
  • RELEASE_NOTES.md
  • ROADMAP.md
  • SKILL_TEMPLATE.md
  • SKILL.md

Discussion (0)

Ask about usage, or say what you built with it

Sign in to join the discussion.

No comments yet. Be the first to say what this is good for.

More skills

Turn any codebase, with its docs, SQL schemas, configs, and PDFs, into a queryable knowledge graph. A /graphify skill for Claude Code, Cursor, Codex, and Gemini CLI: local deterministic AST parsing, every edge explained, no vector store.

117k
1 add
Vincentwei1021/
anything2explainer

Topic in, narrated explainer video out. A Claude Code / Codex skill that turns any topic into a black-canvas motion-graphics explainer video with TTS voiceover, subtitles and a chapter progress bar. Chinese or English; every frame drawn in code with Remotion.

666

Open-source AI job search: scan job portals, evaluate listings into a structured A-H report with a global 1-5 score, tailor your CV, track applications — runs locally in your AI coding CLI (Claude Code, Codex, OpenCode, Antigravity…)

71k

Agent skill for beautiful, verifiable architecture, workflow, sequence, data-flow, and lifecycle diagrams—self-contained HTML with motion and crisp export.

57k
ayghri/
i-have-adhd

A skill to stop your coding agent from burying the answer. ADHD-friendly output.

38k