CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

git-story-film

Direct an animated film of about two minutes from a software repository's Git history. Select real commits, releases and reverts; develop the story, character and visual style; build an outline, cast sheet, storyboard and HTML review studio; then render a 4K/60fps MP4 after approval. Use for repository or product promos, launches, anniversaries, release stories, codebase timelines, character-led project histories, and requests such as "make a video about our project" or "show how this product grew." Not for UI screen recordings, slide decks, or commit-statistics charts.

78

Quality

98%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

96%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A dense, well-directed skill body: lean prose that trusts the reader, copy-paste commands for every step, and a seven-step workflow with explicit approval gates and verification loops. The only weakness is bundle integrity — the engine and example directories it repeatedly points to are not present, which undermines both the setup steps and the reading map.

Suggestions

Ship the `engine/` directory (core.js, cels.js, studio.js, studio-ui.js, materials.js, render.mjs, plus its LICENSE) with the skill, or change the setup step that says "copy `engine/*`" to fetch it from the attributed alesha-pro/tools repository, since the body and reading map both depend on files that are not in the bundle.

Include `examples/raven-story/` (raven.html, cast-sheet.html, the zh/ assets, and storyboard/storyboard.html) in the bundle: the Reading map directs the reader there to see "how the pieces fit in real code," and the setup step for journey films starts from it.

After adding those directories, re-check the flat-copy instruction ("change those script paths to the local filenames") against the shipped example so the referenced relative links (`../../engine/`) resolve as described.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence — it uses `git clone --filter=blob:none`, animation "ones/twos", and ffprobe verification without explaining any of them, and pushes detail to references ("Templates, shot fields and checks are in `references/directing.md`"). Every sentence instructs or sets a decision rule; nothing explains concepts Claude already knows. It is not 4 because no section is trimmable padding — even rationale lines like "A 4K render is the most expensive place to find a problem" justify a rule in one line.

5 / 5

Actionability

Guidance is fully executable with copy-paste commands and flags: "`python3 scripts/storyboard.py shots.json --frames storyboard/frames --out storyboard/storyboard.html --ui en`", "`node render-hq.mjs film.html --width 3840 --fps 60`", "run `npm i` and `sh scripts/fetch_fonts.sh <dir>`". Even the variant cases are concrete — the Chinese film lists the exact files to take from `zh/` ("raven-cast.js, raven-world.js, raven-route.js and raven-flight.js") and the copy step warns about the exact script-path change needed. Not 4: the common cases (journey, Chinese, other forms) each have specific, runnable instructions with no gaps.

5 / 5

Workflow Clarity

The director's workflow is a clear seven-step sequence where "Each ends with something the user can look at, and you stop for their approval before the next." Validation is explicit at each gate: step 5 "Check your own work with the preview tools (`references/production.md` §2)", step 6 "Iterate on the user's notes until they approve", step 7 "Verify with ffprobe and a full decode, and report duration, size, resolution and what you actually looked at." These are genuine feedback loops (preview → fix, studio notes → revise, decode → report), matching the top anchor; not 4 because checkpoints are explicit rather than implicit.

5 / 5

Progressive Disclosure

Structure is good: a Reading map table that maps situations to files, a Scripts table with exact CLI signatures, and one-level-deep references — every cited section resolves in the shipped files (story.md §1–§6, craft.md §1–2/§3/§8, production.md §1–§3 all exist). However, the bundle directories `engine/` ("copy `engine/*`", "comments in `engine/core.js`, `engine/cels.js`, `engine/studio.js`") and `examples/raven-story/` (a Reading map row and the setup's starting point) are referenced throughout but absent from the provided bundle, so navigation to a major part of the skill breaks. Not 5 because of these dangling paths; not 3 because the references that do exist are clearly signaled and content is appropriately split.

4 / 5

Total

19

/

20

Passed

Description

100%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

An exemplary description: it states the full capability pipeline in third person, gives explicit and quotable use-when triggers with occasions and synonyms, and closes with a not-for list that sharply bounds it against neighboring video and chart skills. No changes needed.

DimensionReasoningScore

Specificity

The description lists multiple specific concrete actions covering the entire workflow: "Select real commits, releases and reverts; develop the story, character and visual style; build an outline, cast sheet, storyboard and HTML review studio; then render a 4K/60fps MP4 after approval." It matches the anchor for comprehensive coverage with named artifacts and a concrete output format, and uses third person throughout. It is not 4 because there is no minor gap — every stage of the skill's pipeline is named.

5 / 5

Completeness

Both what and when are explicitly and concretely answered. The what is the full pipeline (direct an ~2-minute animated film from Git history through outline, cast sheet, storyboard, studio, and 4K/60fps render); the when is an explicit "Use for..." clause with concrete trigger phrases, plus a negative boundary ("Not for UI screen recordings, slide decks, or commit-statistics charts"). This is the anchor example of clearly answering both.

5 / 5

Trigger Term Quality

Trigger coverage is comprehensive and includes synonyms, use occasions, and verbatim natural user requests: "repository or product promos, launches, anniversaries, release stories, codebase timelines, character-led project histories, and requests such as 'make a video about our project' or 'show how this product grew.'" Quoting the exact phrases a user would say is the strongest form of this anchor; no natural term is missing.

5 / 5

Distinctiveness Conflict Risk

It occupies a clear niche — animated storytelling films built from a repository's Git history — with distinct triggers ("make a video about our project", "show how this product grew") and an explicit exclusion list that separates it from screen-recording, slide-deck, and commit-statistics skills. Minimal conflict risk; not 4 because the exclusions leave essentially no overlap with adjacent skills.

5 / 5

Total

20

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

EverMind-AI/Raven

Path

skills/git-story-film/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.