Orva-Studio/hance / skills
hance
FlaggedApply cinematic film looks to images/video via the Hance CLI. Use when asked to grade, color, or "make it look like" film.
/hance
A single entry point that routes to one of six subcommands: setup, run, try, refine, batch, ui.
Routing
Pick the subcommand from the user's request. When in doubt, ask.
| User intent | Subcommand | Doc |
|---|---|---|
| "install hance" / "set up hance" | setup | subcommands/setup.md |
| "apply to " / "grade with " | run | subcommands/run.md |
| "make this look like X" / "match this reference" / "show me some looks for this" | try | subcommands/try.md |
| "make this one look better" / "tune/refine this grade" / "more grain, warmer, etc." | refine | subcommands/refine.md |
| "apply X to all of these" / batch a folder | batch | subcommands/batch.md |
| "open the editor" / "open the UI" | ui | subcommands/ui.md |
Runner selection (every subcommand)
Pick one runner per invocation, in order:
- If
command -v bunsucceeds → usebunx @orva-studio/hance(preferred — fast cold-start, cached after first fetch). - Else if
command -v nodesucceeds → usenpx @orva-studio/hance. - Else → inform the user that a compiled binary is available for download from GitHub releases, but do not install it for them.
Runner priority: Bun (bunx), then Node (npx), then compiled binary as a last resort. Never install the binary for the user — just let them know it exists if they have neither Bun nor Node. Every subcommand must work on a fresh machine; setup only verifies runtime + ffmpeg and shows examples.
The compiled binary expects a hance-gpu sidecar alongside it; a bare ./hance checkout without it fails with ENOENT … hance-gpu. This is why bunx/npx are preferred — they always work. When developing in this repo, run the source directly: bun run packages/cli/src/cli.ts ….
Hard rules
- Never invent flags. Only use names listed in
hance --helporhance preset --help. - Never run a full video render to explore looks — use
hance preview(still frame) fortry. - Windows is unsupported. If
uname -sreports Windows, stop and tell the user.
References
references/preset-index.md—presets/index.jsonschema and rebuild contract.references/compare-page.md—/compareroute query params and Edit hand-off.references/grading.md— how to judge and dial in a film look: the render→read→adjust loop, what makes a grade read as film, and common artifacts. Read beforerefine.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 197k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |