reference-decode — Claude Code skill: what it does, how to install
reference-decode turns a reference clip, frame, or contact sheet into prompt structure: hook essence, viewer question, visual grammar to copy, and imitation boundaries.
no license 1,000 installs ★ 26 updated 2026-10-31
npx skills add PostPlusAI/postplus-skills --skill reference-decode -a claude-codeWhat reference-decode does
The skill reads a benchmark video or frame set and extracts four objects: hookEssence (the opening mechanism), viewerQuestion (the question that holds attention), mustCopyVisualGrammar (what to repeat: shot order, object logic, timing), and forbiddenDrift (what not to copy — faces, wardrobe, exact location). Without a reference, it runs in proxy mode: builds structure from a segment pattern and the brief.
The process starts with the smallest set: the first 0–5 seconds of a clip, a hook contact sheet, or a note. The skill separates grammar from identity: it keeps camera work, order, object relationships; it drops exact appearance details. The output is a compact artifact passed to image-batch-runner or video-batch-runner before generation. Paid operations need PostPlus credits; without balance, the skill stops.
Works in Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode. Install with npx skills add PostPlusAI/postplus-skills --skill reference-decode -a claude-code, and the file lands in ~/.claude/skills/reference-decode/SKILL.md.
What it helps with
- break down a reference clip into hook, viewer question, and visual grammar
- separate frame structure from specific faces and details before prompting
- build prompt structure from a brief when no reference exists
- pass grammar to
image-batch-runnerorvideo-batch-runnerwithout extra artifacts
Example prompts for the agent
- Take the first five seconds of
ref/hook.mp4and pull out the hook, viewer question, what to copy, and what not to. - From the contact sheet in
board/intro-frames.png, assemble prompt structure: opening essence, frame grammar, and boundaries. - No brief, but I need a prompt for a three-answer segment: build a proxy structure with scene anchors.
How to install reference-decode
1Skills CLI (Vercel)
npx skills add PostPlusAI/postplus-skills --skill reference-decode -a claude-code2Manually: put the files in place
~/.claude/skills/reference-decode/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/reference-decode/
1Skills CLI (Vercel)
npx skills add PostPlusAI/postplus-skills --skill reference-decode -a codex2Manually: put the files in place
.agents/skills/reference-decode/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add PostPlusAI/postplus-skills --skill reference-decode -a cursor2Manually: put the files in place
.cursor/skills/reference-decode/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install PostPlusAI/postplus-skills skills/10-routing/reference-decode2Manually: put the files in place
.github/skills/reference-decode/SKILL.md1Skills CLI (Vercel)
npx skills add PostPlusAI/postplus-skills --skill reference-decode -a gemini-cli2Platform CLI
gemini skills install https://github.com/PostPlusAI/postplus-skills --path skills/10-routing/reference-decodeManually: put the files in place
.devin/skills/reference-decode/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add PostPlusAI/postplus-skills --skill reference-decode -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about reference-decode
How to install reference-decode in Claude Code?
Run npx skills add PostPlusAI/postplus-skills --skill reference-decode -a claude-code. The skill will appear in ~/.claude/skills/reference-decode/SKILL.md.
What does reference-decode do?
It reads a reference clip, frame, or contact sheet and extracts hook essence, viewer question, visual grammar (what to repeat), and imitation boundaries (what not to copy). The result is passed to generation as prompt structure.
What does forbiddenDrift mean in the skill output?
A list of what not to copy from the reference: faces, exact wardrobe, location, overlays, creator identity. The skill separates structure (shot order, timing, object logic) from details that would make the result plagiarism.