Agent skill

Story Pitch

by jamditis in jamditis/claude-skills-journalism

Crafts story pitches for different outlets. An agent skill from jamditis/claude-skills-journalism.

MITAuto-check passed

Install Story Pitch

skills CLI
$ npx skills add jamditis/claude-skills-journalism --skill story-pitch -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install jamditis/claude-skills-journalism story-pitch --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/jamditis/claude-skills-journalism.git skills-src && mkdir -p .claude/skills && cp -r skills-src/journalism-core/skills/story-pitch .claude/skills/story-pitch && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
story-pitch
GitHub stars
416
Token cost
~3.2k tokens
SKILL.md length
599 words
Files
2
Skills in repo
53
Repo updated
First seen
Licence
MIT

At a glance

Crafts story pitches for different outlets. An agent skill from jamditis/claude-skills-journalism.

  • Works in 5 steps: The hook: Why should anyone care? Why now? → The story: What will you… → The evidence: What do you have? What can… → …
  • Pitching editors
  • SKILL.md covers When to use, The pitch fundamentals, Pitch templates by type and Developing the angle, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Story Pitch is an agent skill from jamditis/claude-skills-journalism. Crafts story pitches for different outlets. Use when pitching editors, writing query letters, or shaping feature or op-ed angles.

Its SKILL.md is about 3.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `agents/openai.yaml`).

The repository describes itself as: Claude Code skills for journalism, media, and academia - verification, FOIA, data journalism, academic writing, and more. The licence is MIT.

When your agent uses it

  • Pitching editors
  • Writing query letters
  • Shaping feature

Example prompts

  • “Use the story-pitch skill to craft story pitches for different outlets. An agent skill from jamditis/claude-skills-journalism”
  • “/story-pitch”

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. The hook: Why should anyone care? Why now?
  2. The story: What will you show/reveal/explain?
  3. The evidence: What do you have? What can you get?
  4. The access: Who will you talk to? What will you see?
  5. The ask: What do you need (time, budget, resources)?

What it can do on your machine

Read from SKILL.md and the folder at commit e3e2172. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are markdown).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Story Pitch loads about 3.2k tokens when it runs. Until then it costs about 35 tokens; SKILL.md has 599 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~35
When it runs · the whole SKILL.md, loaded when a task matches
~3.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from jamditis/claude-skills-journalism at commit e3e2172, republished under its MIT licence (© jamditis). 599 words, ~3,236 tokens.

Download SKILL.mdSave it as .claude/skills/story-pitch/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
story-pitch
description
Crafts story pitches for different outlets. Use when pitching editors, writing query letters, or shaping feature or op-ed angles.

Story pitch guide

Good stories die in bad pitches. This skill covers pitch structure, angle development, and outlet-specific formatting.

When to use

  • Pitching stories to editors (internal or external)
  • Developing freelance query letters
  • Refining story angles before reporting
  • Competing for assignment in a newsroom
  • Proposal writing for grants or fellowships

The pitch fundamentals

What every pitch needs
  1. The hook: Why should anyone care? Why now?
  2. The story: What will you show/reveal/explain?
  3. The evidence: What do you have? What can you get?
  4. The access: Who will you talk to? What will you see?
  5. The ask: What do you need (time, budget, resources)?
The "so what" test

Before pitching, answer:

  • Why this story? (significance)
  • Why now? (timeliness/news hook)
  • Why you? (access, expertise, angle)
  • Why this outlet? (audience fit)

If you can't answer all four, you're not ready to pitch.

Pitch templates by type

Daily news pitch

For quick-turn stories to assignment editors.

markdown
**Slug:** [2-3 word identifier]
**Pitch:** [One sentence: What's the news?]
**Why now:** [What makes this timely?]
**Sources:** [Who you'll talk to]
**Timeline:** [When you can file]
**Format:** [Length, multimedia]

Example:
**Slug:** Council-Budget-Vote
**Pitch:** City council votes tonight on controversial police budget increase.
**Why now:** Final vote after months of debate, protests expected.
**Sources:** Council president, protest organizers, police union rep.
**Timeline:** File by 10pm for morning.
**Format:** 600 words + photos from hearing.
Feature pitch

For longer-form stories with more development time.

markdown
## [Working title]

**The story in one sentence:**
[What is this story about?]

**The hook:**
[Why should readers care? What's the emotional/intellectual entry point?]

**What's new:**
[What do you know/have that hasn't been told?]

**The shape:**
[How will you tell it? Narrative structure, key scenes, characters]

**Sources and access:**
[Who will you interview? What will you witness? Documents?]

**Visuals:**
[Photo opportunities, graphics, multimedia]

**Timeline and resources:**
[How long to report? Write? What do you need?]

**Why me:**
[Your connection to story, relevant expertise, access]

Example:

## The last ferry captain

**The story in one sentence:**
After 47 years, the last original captain of the Staten Island Ferry is retiring, and taking decades of institutional knowledge with him.

**The hook:**
8 million New Yorkers depend on this ferry. Most have never met the people who run it. Captain Mike Carbone has seen mayors come and go, survived 9/11 from the water, and trained every current captain. His retirement is the end of an era.

**What's new:**
No one has profiled the ferry crews since the 2003 accident. Carbone has agreed to a ride-along on his final week. He's kept a journal since 1977.

**The shape:**
Narrative profile. Open with his final departure. Flash back through career highlights. Include voices from crew, family, passengers he's befriended across decades.

**Sources and access:**
- Carbone (confirmed, ride-along approved)
- NYC DOT ferry division chief
- Other captains he's trained
- Regular commuters
- His family

**Visuals:**
Photographer on ride-along. Harbor shots at dawn. Carbone's home with memorabilia. Archive photos from his collection.

**Timeline and resources:**
2 weeks reporting, 1 week writing. Need photographer availability for 3 early mornings.

**Why me:**
I grew up taking this ferry and have always wanted to tell this story. I've already built rapport with Carbone through initial conversations.
Investigation pitch

For accountability journalism requiring significant resources.

markdown
## [Working title]

**The thesis:**
[What we can prove / what we suspect]

**Why it matters:**
[Impact: Who is harmed? How much money? How many people?]

**What we have:**
[Documents, sources, data already obtained]

**What we need:**
[Additional reporting required]

**Key sources:**
[Who will talk? On/off record? Whistleblowers?]

**Documentary evidence:**
[FOIA requests needed? Court records? Financial filings?]

**Legal considerations:**
[Defamation risk? Source protection needs?]

**Competitive risk:**
[Is anyone else on this? Why now?]

**Timeline:**
[Realistic assessment of time to report, write, edit, legal review]

**Resources needed:**
[FOIA costs, travel, data analysis, graphics, multimedia]

**Publication plan:**
[Single story? Series? Rolling publication?]

Example:

## State contracts going to insiders

**The thesis:**
More than $50 million in state construction contracts across five years went to companies with personal ties to procurement officials, circumventing competitive bidding.

**Why it matters:**
Taxpayers are overpaying for public projects. At least three bridges have needed early repairs after work by connected contractors.

**What we have:**
- State contract database (scraped, analyzed)
- Corporate filings showing ownership connections
- Two former procurement employees willing to talk (one on record)
- Email chain showing official steering business to friend

**What we need:**
- Additional FOIA for internal communications
- More contractors willing to describe losing bids unfairly
- Engineering review of the bridge repair patterns
- Response from officials named

**Key sources:**
- Whistleblower A (on record, documented complaint)
- Whistleblower B (background only, fears retaliation)
- Contractor who lost bids (on record)
- Engineering expert for bridge assessment
- Officials (will request comment before publication)

**Documentary evidence:**
- Contract awards (public, obtained)
- Corporate filings (public, obtained)
- Internal emails (FOIA pending)
- Inspection reports (FOIA pending)

**Legal considerations:**
All claims will be documented. We'll seek comment from everyone named. Standard defamation review needed.

**Competitive risk:**
Local TV did a segment on one bridge last year but didn't connect the pattern. This is a deeper investigation.

**Timeline:**
8-10 weeks total. 6 weeks additional reporting, 2 weeks writing/editing, 2 weeks legal/response period.

**Resources needed:**
$2,000 FOIA costs, data analysis support, one reporting trip to state capital.

**Publication plan:**
Main story (3,000 words) + database for readers to search contracts + methodology box.
Op-ed pitch

For opinion/commentary pieces.

markdown
Subject: Op-ed submission: [Headline]

Dear [Editor name],

[One paragraph: What's your argument? Why now?]

[One paragraph: Why are you qualified to make this argument?]

[One paragraph: Why is this right for your publication's audience?]

The piece is [word count] words and is exclusive to [publication].

[Your name]
[Credentials/bio]
[Contact info]

---

Example:

Subject: Op-ed submission: School board's DEI cuts will hurt all students

Dear Opinion Editor,

When the Westfield school board votes Tuesday to eliminate diversity coordinators, they won't just hurt minority students, they'll deprive every student of the skills employers demand. I've spent 20 years in HR at Fortune 500 companies, and I can tell you: businesses want graduates who can work across difference. This decision makes our kids less competitive.

As the former Chief People Officer at [Company] and a Westfield parent, I've seen both sides of this issue. I'm not an activist; I'm a business leader who knows what the job market requires.

Your editorial page has covered school budget debates extensively. Your readers, many of them parents in our district, need to hear from someone who can translate business needs into educational priorities.

The piece is 750 words and is exclusive to [Publication].

Jane Smith
Former CPO, [Company]
Westfield School District parent
jane@email.com / 555-0123
Freelance query letter

For pitching to publications you don't work for.

markdown
Subject: Pitch: [Compelling headline]

Dear [Editor name],

[Opening hook, the most compelling detail or question from your story]

[What the story is, who it's about, what you'll show]

[Why now, the news hook or timely angle]

[What you have, sources confirmed, access secured, documents obtained]

[Why this publication, how it fits their coverage, audience]

[Why you, relevant clips, expertise, access]

I estimate [word count] words and can deliver in [timeframe].

Thank you for your consideration.

[Your name]
[Brief bio]
[Links to 2-3 relevant clips]
[Contact info]

---

Example:

Subject: Pitch: The nurse who tracks fake diplomas

Dear [Editor],

Maria Chen has caught 47 nurses with fake degrees in three years. None of them through background checks, but through a spreadsheet she maintains in her free time.

Chen, a nursing supervisor at a rural Oklahoma hospital, started her database after discovering a colleague had purchased credentials from a diploma mill. State nursing boards, she found, rarely verify foreign credentials thoroughly. Her volunteer work has exposed a patient safety gap that regulators have ignored.

Her story comes as Oklahoma debates licensure reform this session, a bill she's testified for and the hospital lobby has opposed. The vote is in six weeks.

I've interviewed Chen twice, reviewed her database and documentation, and spoken with three of the fraudulent nurses she identified (two on background). The state nursing board has agreed to comment.

This fits [Publication]'s healthcare accountability coverage. Your recent piece on physician oversight touched on similar regulatory gaps.

I've covered healthcare regulation for [outlets] and have sources at several state nursing boards. My recent piece on travel nurse agencies for [outlet] is attached.

I estimate 2,500 words and can deliver in four weeks.

Thank you for your consideration.

[Name]
Freelance health reporter
[Clip links]
[Contact]

Developing the angle

Finding the hook

Ask yourself:

  • What's the conflict? (Who's fighting whom?)
  • What's the tension? (What's at stake?)
  • What's the surprise? (What will readers not expect?)
  • What's the emotion? (What will readers feel?)
  • What's the question? (What don't we know?)
The "dinner table" test

Can you explain this story in one sentence to someone at dinner?

Too vague: "It's about problems with the foster care system."

Too inside baseball: "It's about how HHS regulations from 2018 created incentive misalignment in Title IV-E funding."

Just right: "Kids in foster care are being moved to different homes so often that some have attended 10 schools in one year, and no one's tracking the damage."

Angle versus topic
TopicAngle
HomelessnessThe family that's been on the housing waitlist for 3 years
Climate changeThe town that's already moving because of rising seas
Healthcare costsThe insulin price that tripled while the patent was extended
EducationThe teacher who's spent $10k of her own money on supplies

Topic is what you're covering. Angle is how you're covering it.

Show full SKILL.md (234 more words)Show less

Common pitch mistakes

The information dump

Wrong: "There's a lot going on with the school board. They've had budget issues, enrollment decline, a superintendent search, and facilities problems. I want to cover all of it."

Better: "The superintendent search is down to two finalists with opposite visions for the district. I'll profile both and explain what's at stake."

The missing news hook

Wrong: "Homelessness is a growing problem in our city."

Better: "The city's eviction filings hit a five-year high last month. Here's what's driving it."

The vague access

Wrong: "I'll talk to homeless people and officials."

Better: "I've been following one family through the shelter system for two months. The housing director has agreed to an interview."

The no-stakes pitch

Wrong: "The museum is having an exhibit on local history."

Better: "The museum's new exhibit includes artifacts a local family claims were stolen during redevelopment. The family wants them back."

After the pitch

If accepted
  • Clarify deadline, length, edit process
  • Confirm kill fee (for freelance)
  • Get editor's preferred contact method
  • Ask about style guide, multimedia needs
If rejected
  • Ask for feedback (briefly, politely)
  • Ask if there's a different angle that would work
  • Keep relationship warm for future pitches
If silence
  • Follow up once after 1-2 weeks
  • If still nothing, you can pitch elsewhere (unless exclusive)
  • Don't take it personally, editors are overwhelmed

The pitch sells the story. The story sells itself after that.

© jamditis, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in journalism-core/skills/story-pitch of jamditis/claude-skills-journalism.

  • SKILL.md
  • agents/openai.yaml

Open the folder on GitHubat commit e3e2172

Compare with similar skills

Story Pitch next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Story Pitch compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Story Pitch this skilljamditis/claude-skills-journalism416—~3.2kAutomated safety check: PassMIT
Story Pitchmohitagw15856/pm-claude-skills1.4k—~720Automated safety check: PassMIT
Ib Pitch Booknexu-io/open-design100k—~2kAutomated safety check: PassApache-2.0
Story ReadinessDonchitos/Claude-Code-Game-Studios26k—~6.9kAutomated safety check: PassMIT
Job Storiesphuryn/pm-skills27k—~743Automated safety check: PassMIT
User Storiesphuryn/pm-skills27k—~748Automated safety check: PassMIT

Similar skills

  • Story Pitch

    mohitagw15856/pm-claude-skills

    Pitch a news or feature story to an editor — the angle, why now, and how you'll report it.

    1.4k GitHub stars~720 tokensUpdated 2 days ago
    Writing & ContentAuto-check passed
  • Ib Pitch Book

    nexu-io/open-design

    OpenDesign's investor pitch book: market map, moat, unit economics, and the ask — analyst-grade and diligence-ready.

    100k GitHub stars~2k tokensUpdated yesterday
    Business, Finance & HRAuto-check passed
  • Story Readiness

    Donchitos/Claude-Code-Game-Studios

    Is a story implementation-ready?. An agent skill from Donchitos/Claude-Code-Game-Studios.

    26k GitHub stars~6.9k tokensUpdated 3 days ago
    Product & Project ManagementAuto-check passed
  • Job Stories

    phuryn/pm-skills

    Turns a feature into job stories in the When, I want to, so I can format, each with six to eight acceptance criteria tied to the user's situation and outcome.

    27k GitHub stars~743 tokensUpdated yesterday
    Product & Project ManagementAuto-check passed
  • User Stories

    phuryn/pm-skills

    Create user stories following the 3 C's (Card, Conversation, Confirmation) and INVEST criteria with descriptions, design links, and acceptance criteria.

    27k GitHub stars~748 tokensUpdated 2 days ago
    Product & Project ManagementAuto-check passed
  • Create Stories

    Donchitos/Claude-Code-Game-Studios

    Break one epic into implementable stories embedding TR-ID, ADR guidance, acceptance criteria.

    26k GitHub stars~7.3k tokensUpdated 3 days ago
    Product & Project ManagementAuto-check passed

More from jamditis/claude-skills-journalism

All 53 skills in this repo
  • Web Design Picker

    jamditis/claude-skills-journalism

    A skill your agent uses when creating distinct website directions, a client review picker, asset catalog, previews, and Cloudflare-ready handoffs.

    416 GitHub stars~3.1k tokensUpdated 6 days ago
    Auto-check passed
  • Okf Wiki

    jamditis/claude-skills-journalism

    Builds an Open Knowledge Format (OKF) knowledge base from existing docs, notes, or a repo.

    416 GitHub stars~4.7k tokensUpdated 6 days ago
    Auto-check passed
  • Private Secret Scanning

    jamditis/claude-skills-journalism

    Local Gitleaks scans for staged changes, push ranges, and full history in private repos, with redacted reports.

    416 GitHub stars~1.8k tokensUpdated 6 days ago
    Auto-check passed
  • Data Journalism

    jamditis/claude-skills-journalism

    Acquire, clean, analyze, verify, visualize, and explain data for journalism.

    416 GitHub stars~1.6k tokensUpdated 6 days ago
    Auto-check passed
  • Document Design

    jamditis/claude-skills-journalism

    Creates print-ready HTML that exports to PDF. An agent skill from jamditis/claude-skills-journalism.

    416 GitHub stars~1.9k tokensUpdated 6 days ago
    Auto-check passed
  • Using Superjawn

    jamditis/claude-skills-journalism

    Establishes how to find and use skills, requiring Skill tool invocation before any response.

    416 GitHub stars~1.5k tokensUpdated 6 days ago
    Auto-check passed

Questions about Story Pitch

What does Story Pitch do?

Crafts story pitches for different outlets. An agent skill from jamditis/claude-skills-journalism. Story Pitch is an agent skill from jamditis/claude-skills-journalism. Crafts story pitches for different outlets.

When should I use Story Pitch?

Story Pitch fits situations like: pitching editors; writing query letters; shaping feature.

How do I install Story Pitch in Claude Code?

Run `npx skills add jamditis/claude-skills-journalism --skill story-pitch -a claude-code`. Or copy the skill folder (journalism-core/skills/story-pitch in jamditis/claude-skills-journalism) into .claude/skills/story-pitch in your project. Claude Code loads it when a task matches its description.

How do I install Story Pitch in Codex?

Run `npx skills add jamditis/claude-skills-journalism --skill story-pitch -a codex`. Or copy the skill folder (journalism-core/skills/story-pitch in jamditis/claude-skills-journalism) into .agents/skills/story-pitch in your project. Codex loads it when a task matches its description.

Can I use Story Pitch in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add jamditis/claude-skills-journalism --skill story-pitch -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/story-pitch, .gemini/skills/story-pitch, .github/skills/story-pitch and .opencode/skills/story-pitch in your project.

What does Story Pitch need to run?

SKILL.md names no scripts, command-line tools or credentials: Story Pitch is instructions for the agent only.

Does Story Pitch access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Story Pitch safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Story Pitch use?

Story Pitch is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Story Pitch use?

About 3.2k tokens (SKILL.md is roughly 13k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Story Pitch?

Skills that share tags, products or a category with Story Pitch: Story Pitch (mohitagw15856/pm-claude-skills, 1.4k stars), Ib Pitch Book (nexu-io/open-design, 100k stars), Story Readiness (Donchitos/Claude-Code-Game-Studios, 26k stars) and Job Stories (phuryn/pm-skills, 27k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Story Pitch?

jamditis (a GitHub user) maintains it in jamditis/claude-skills-journalism, which has 416 GitHub stars. The repository holds 53 skills in this directory. The repository was last updated on October 4, 2026.

Source: jamditis/claude-skills-journalism on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.