hyv-shotlister

hyv-shotlister is an agent for Claude Code from killernay/HearYourVOICE. It costs 113 tokens per session (625 once invoked), scanned B, original, MIT.

A shot-list builder for HearYourVOICE, a video-production workflow. It turns a storyboard into an Excel workbook with one row for each unique piece of footage or visual insert, including sourcing and usage details.

In plain words
What is it for?
Use it to create and fill `shotlist.xlsx`, assign shot IDs, record how each visual will be obtained, track episode coverage, and manage status.
Why use it?
It gives the production pipeline one shared plan that connects planned shots, episodes, sources, licenses, and progress.

Agent for Claude Code

Written for Claude Code: shipped in a Claude Code plugin. Also seen: model in frontmatter; reads .claude/ paths; mentions Claude Code.

Needs its repository: it runs a file that does not travel with it, so clone the repository first. The line is HYV=$(ls -d ./.claude/skills/hearyourvoice ~/.claude/skills/hearyourvoice 2>/dev/null | head -1).

Part of the HearYourVOICE plugin — 1 skill, 16 agents shipped together

Good fit Use it to create and fill shotlist.xlsx, assign shot IDs, record how each visual will be obtained, track episode coverage, and manage status.

Compare 6 agents from other repositories ↓
Install

Getting it into your agent

It runs from inside its repository, so the clone comes first — what it calls does not travel with the file alone.

Clone the repo
git clone --depth 1 https://github.com/killernay/HearYourVOICE
agentmods
npx agentmods add agents/killernay/hearyourvoice/hyv-shotlister

Made for: Claude Code.

Or install HearYourVOICE, the plugin that ships this one along with the rest of its 1 skill, 16 agents.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for hyv-shotlister

README.md
[![agentmods](https://agentmods.dev/badge/agents/killernay/hearyourvoice/hyv-shotlister/github.svg)](https://agentmods.dev/agents/killernay/hearyourvoice/hyv-shotlister)
Your own site
<a href="https://agentmods.dev/agents/killernay/hearyourvoice/hyv-shotlister"><img src="https://agentmods.dev/badge/agents/killernay/hearyourvoice/hyv-shotlister/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for hyv-shotlister

Your own site · 80×15
<a href="https://agentmods.dev/agents/killernay/hearyourvoice/hyv-shotlister"><img src="https://agentmods.dev/badge/agents/killernay/hearyourvoice/hyv-shotlister.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 113 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 625 The whole file, excluding the scripts and references it only reads on demand.
Security scan B 1 finding. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00113 $0.00625
Opus 5 $0.00056 $0.00313
Sonnet 5 $0.00023 $0.00125
Haiku 4.5 $0.00011 $0.00063

Measured 10d ago against content hash 513483760af3, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-10, from the pricing page.

Security

Grade B, and why

hyv-shotlister scanned grade B with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 10d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Enumerates other installed skillsmediumAgent snooping

Other skills' SKILL.md files reveal prompts, capabilities and secrets that should be invisible to peers.

HYV=$(ls -d ./.claude/skills/hearyourvoice ~/.claude/skills/hearyourvoice 2>/dev/null | head -1)
agents/hyv-shotlister.md · 52 lines

What it actually says

hyv-shotlister — คนทำ shotlist (Phase 1e)

The shotlist is the single artifact the rest of the pipeline runs on. One row per unique shot; its shot IDs flow into the insert plan and the attribution list.

Where the scripts live (resolve this first)

Every scripts/… path below lives inside the installed skill, not the project you are working in. Resolve it once, then prefix every call:

HYV=$(ls -d ./.claude/skills/hearyourvoice ~/.claude/skills/hearyourvoice 2>/dev/null | head -1)

Then call scripts as node "$HYV/scripts/<name>.mjs" (or python3 "$HYV/scripts/<name>.py"). If $HYV is empty, or you have no shell at all, then this step cannot run here — that is a surface limit, not a bug. Stop and tell the human this phase needs Claude Code with the skill installed (npx hearyourvoice install). Never fake the result to keep going.

Task

  1. Read src/<slug>/storyboard.md and references/shotlist-format.md.
  2. Scaffold with python scripts/new-shotlist.py (needs openpyxl) or copy the example workbook.
  3. Fill the 5 sheets: for each unique shot give a category-prefixed shot ID (e.g. TALK-01, CITY-03), planned capture/source (self-shot | cc | generative | graphic), license, batch/coverage, and a status (planned | captured | sourced | generated | done).
  4. Mark which beats reuse which shot; flag shots with no source yet — those are the gaps the cc-scout and veo-prompt-smith will pick up.

Output (final message)

shotlist: src/<slug>/shotlist.xlsx
shots: N total — cc:X · self-shot:Y · generative:Z · graphic:W
open (no source yet): <list of shot IDs>   ← hand these to cc-scout / veo-prompt-smith

Keep the status column honest — it is how the producer knows what's left.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 10d ago First seen · 52 lines · 113 tokens per session scan B 513483760af3

Subscribe to this mod's changes

hyv-shotlister is an agent published in the GitHub repository killernay/HearYourVOICE (140 stars, last pushed 1mo ago), licensed MIT. It adds 113 tokens to every session and 625 once invoked, about $0.0006 per session on Opus 5. A static security scan graded it B with 1 finding (enumerates other installed skills). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other agents, from other repositories

table-of-contents-generator

Table of Contents Generator. Generate EXACTLY the table of contents slide. REQUIRED inputs: font family, color palette, slide index, slide content (section list with titles). the number of total slides. DO NOT PROVIDE layout specifications.

MiniMax-AI/skills · 0 tokens

china-model-builder

Builds DCF, LBO, 3-statement, and comps models for Chinese equities using AkShare-sourced financial data. Use when a user requests a full financial model for an A-share stock. Not for one-off calculations.

jwangkun/claude-for-financial-services-cn · 52 tokens

china-model-builder

A financial-modeling agent for Chinese mainland stock-market companies. It builds linked Excel workbooks for discounted cash flow valuation, comparable-company analysis, and forecasts of the income statement, balance sheet, and cash-flow statement.

cyijun/china-financial-services · 51 tokens

chart-designer

A spreadsheet chart and visualisation assistant. It chooses or creates charts such as bar, line, pie, scatter, and combination charts, and can apply visual formatting.

claude-office-skills/claude-office-plugin · 87 tokens

cell-engine-builder

A builder for a spreadsheet engine, the software that stores cells and sheets and calculates formulas. It also implements built-in spreadsheet functions.

revfactory/claude-code-harness · 0 tokens

quality-checker

A read-only spreadsheet agent that checks data, formulas, totals, references, and logical consistency, then reports its findings.

claude-office-skills/claude-office-plugin · 75 tokens