Skip to content

ur-grue/autopunk-media-skills

Repository files navigation

autopunk-media-skills

Skills Eval License G-Eval GitHub stars Agents


Install

# Clone the full library
git clone https://github.com/ur-grue/autopunk-media-skills.git ~/.claude/skills/autopunk-media-skills

# Or install individual skills
npx skills add ur-grue/autopunk-media-skills --skill hook-generator

Compatible with: Claude Code · Cursor · Codex CLI · Gemini CLI · OpenCode · any agent supporting the Agent Skills standard.

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


What Is This?

This is a free collection of Claude skills — ready-to-use prompts and instructions that turn Claude into a specialist for media production work.

Skills follow the open Agent Skills standard — they work in Claude Code, Cursor, Codex CLI, Gemini CLI, OpenCode, and any compatible coding agent.

Think of each skill as hiring an expert collaborator for one specific task: writing a pitch treatment, generating SEO-optimized YouTube titles, cleaning up an interview transcript, or building a cinematic image prompt from scratch.

No coding required. No technical knowledge needed. Pick a skill, give Claude what it needs, and get professional-grade output.


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.


Quick Start

Here's what the hook-generator skill produces. Try it yourself — paste the prompt below into Claude, run it through your coding agent, or load it from the cloned library.

Example input:

You are a YouTube hook specialist. Your job is to write the first 15–30 seconds
of a YouTube video script — the hook that stops the scroll and forces the viewer
to keep watching.

My video is about: the hidden reason most people fail at learning a new language
as an adult — and why the standard advice about "immersion" is scientifically wrong.

Target audience: adults aged 28–45 who have tried and failed to learn a language
before and feel frustrated with their own progress.

Tone: direct, slightly provocative, backed by science — not motivational-speaker energy.

Write 3 alternative hooks. For each: write the full script, then a one-line note
explaining the psychological mechanism it uses.

Example output:


Hook A — The Broken Promise

"Every language app, every tutor, every Reddit thread told you the same thing: immerse yourself. Surround yourself with the language. Just listen. Just watch. Just live it.

You did that. For months. And you still can't hold a conversation.

Here's what they didn't tell you — and what the research has known since 1985."

Mechanism: Validates the viewer's failure as a systemic problem, not personal inadequacy. Creates urgency to hear the explanation.


Hook B — The Number

"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."

Mechanism: Specific statistic creates credibility shock. "Nobody taught you" frames the video as access to suppressed information.


Hook C — The Confession

"I spent three years living in a country where I didn't speak the language. By the end, I could order coffee and ask for directions. That's it. Three years.

Turns out, immersion without one specific ingredient is just expensive confusion. Here's the ingredient."

Mechanism: First-person failure story creates identification, then reframes failure as solvable. "Expensive confusion" is memorable.


That's the quality level you get from every stable skill in this library.


What's In The Library

Category Skills What It Covers
TV Documentary 28 skills development · pre-production · scripting · post-production · localization · business
Magazine Journalism 39 skills ideation · writing · editing · investigation · fact-checking · legal · distribution
YouTube 18 skills pre-production · scripting · post-production · channel strategy · business · analytics
Podcast 12 skills pre-production · scripting · post-production · business
Image Prompting 10 skills Midjourney · Flux · art direction · workflows
Media Business 19 skills pitching · distribution · funding · legal
Social Media 11 skills content · strategy
Radio / Audio 12 skills scripting · news packages · production · strategy
Newsletter 13 skills writing · strategy · growth · monetization
PR / Communications 13 skills press office · crisis comms · media relations · content
Screenwriting 9 skills development · scripting · revision · production
Data Journalism 15 skills analysis · visualization · investigation · publishing
Research 18 skills people · background · fact-checking · academic · media · logistics
Translation 7 skills text · institutional · digital · reference · quality · localization
Production Support 7 skills formatting · reference
Total 354 skills

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


Quality Badges

Every skill displays a status badge so you know exactly how production-ready it is.

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 rigorous six-dimension quality evaluation earn stable status. The evaluation tests coherence, consistency, fluency, relevance, professionalism, and actionability — scored by Claude against a rubric aligned to real media industry standards.

See tests/EVAL_FRAMEWORK.md for the full process.


Example Outputs

Two short examples showing the quality standard across different categories. Each is a real output from the skill, generated with a generic input.


Logline · logline-creator · TV Documentary

Input: Feature documentary about a team of forensic archivists who recover destroyed government records from degraded magnetic tape.

Output:

"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 · TV Documentary

Input: Nature documentary series, six parts, following migrating bird species across three continents. Tone: prestigious, PBS-adjacent.

Output:

"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?

On The Wing is a six-part natural history series that follows the Arctic Tern — the animal that experiences more daylight than any other creature on Earth — across the full length of its annual migration. For the first time, miniaturized tracking technology reveals a route that defies every existing model."


How To Use A Skill

Option A — Clone the library (recommended for coding agents)

git clone https://github.com/ur-grue/autopunk-media-skills.git ~/.claude/skills/autopunk-media-skills

Skills are automatically available in Claude Code, Cursor, Codex CLI, Gemini CLI, OpenCode, and any agent that reads from a skills directory.

Option B — Copy and paste (fastest for a single task)

  1. Find the skill you need in the skills/ folder
  2. Read the "What You Need To Provide" section
  3. Paste the skill into Claude along with your material

Option C — Reference from your project

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


First Time Here?

Not sure where to start? These guides will get you up and running fast.

Guide What It Does
Getting Started Pick your role, get 3 starter skills, start producing
Writing Better Inputs How to brief Claude 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

Workflows

Most real projects use multiple skills in sequence. These step-by-step 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

How To Contribute

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

Quality Testing

226 skills tested against binary assertions using diverse inputs (standard, minimal, European context). 2,354 / 2,390 checks passed (98.5%). Radio/Audio and PR/Communications scored 100%.

All 36 failures 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


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.

Built by a commissioning editor with 15+ years in European public broadcasting. These skills encode real production knowledge from documentary development, magazine journalism, broadcast scripting, and international co-productions.

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