Overview

Hance ships with an AI agent skill that lets you grade footage using natural language. No CLI knowledge needed. Describe the look you want and the agent handles the rest.

Install the skill

Install via skills.sh:

npx skills add orva-studio/hance

Once installed, type /hance in your AI agent to get started.

The skill is also baked into the hance binary itself. Any agent harness can pull the same instructions at runtime — version-matched to the installed CLI, no separate install — via hance skills:

hance skills              # the router / entry doc
hance skills list         # available subcommand + reference docs
hance skills get refine   # print one doc
hance skills path         # extract the docs to a local dir

How it works

The skill uses bunx @orva-studio/hance (or npx as fallback) under the hood, so no global install is needed. It automatically detects your runtime and picks the fastest available runner.

Subcommands

The /hance skill routes to one of six subcommands based on what you ask for. See the Skill Commands page for full details.

Command	Description
/hance setup	Verify your environment is ready
/hance run	Apply a preset to a single file
/hance try	Explore and compare looks in a browser UI
/hance refine	Dial in one look on one file, iterating on a preview
/hance batch	Apply one preset to multiple files
/hance ui	Open the browser-based editor

Machine-readable docs

These docs are published in formats built for LLMs and agents:

• /llms.txt: an index of the documentation, following the llms.txt convention, with links to every page.
• Plain Markdown: append .md to any page URL to fetch its raw Markdown (frontmatter stripped). For example, this page is available at /agent/overview.md.

Point your agent at /llms.txt to let it discover and pull in the relevant pages on demand.