mcpField
R
reference-decode

reference-decode

github.com/postplusaiCreative & media271.0k installsUpdated 1d ago
Repository

About reference-decode

reference-decode is a creative skill for turning video or other source material into a structured brief before storyboarding or prompt writing. It separates reusable visual structure from identity details and also supports a proxy mode when no reference is available.

Key features

  1. 01Extracts hook and viewer question
  2. 02Identifies reusable visual grammar
  3. 03Records drift to avoid
  4. 04Supports no-reference proxy mode
  5. 05Hands off decoded context

Use cases

  1. 01Prepare a benchmark clip for storyboard work
  2. 02Structure a brief before writing prompts
  3. 03Build a proxy from a reference-free brief

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/postplusai/postplus-skills --skill reference-decode

After installing, type/reference-decodein Claude Code to confirm it loaded.

Details

From the project README

Reference Decode

Use When

  • A benchmark video, contact sheet, frame set, rough idea, or source material needs to become promptable structure.
  • You need the hook essence, viewer question, visual grammar, and forbidden drift before storyboard or request writing.
  • A no-reference brief still needs a proxy structure before prompt work.

Do Not Use When

  • Do not create the final storyboard grid or execution request here.
  • Do not copy faces, exact wardrobe, creator identity, exact location, or exact overlays from benchmark material.

Core Rule

Do not summarize references as "good vibe", "nice pacing", or "strong chemistry". Extract four objects:

  • hookEssence
  • viewerQuestion
  • mustCopyVisualGrammar
  • forbiddenDrift

Default Workflow

  1. Use the smallest sufficient source set: hook-first clip, first 0-5 seconds, hook-first contact sheet, supporting note, or full style board only if needed.
  2. Decode the opening mechanism: first clear promise, viewer question, and the exact visual structure that makes the promise legible.
  3. Separate structure from identity. Keep camera grammar, shot order, object logic, timing, and relationship logic; do not keep exact identity details.
  4. Create a compact decode artifact when it is useful.
  5. Print or return the decode block before storyboard or request writing.

No-Reference Mode

When no usable reference exists, operate in proxy mode:

  • start from the chosen segment pattern
  • infer the likely viewer question
  • express must-copy grammar as scene anchors, not imitation notes
  • express forbidden drift as anti-generic safeguards
  • state that the output is brief-derived, not observed from footage

Output Shape

The artifact contains hookEssence, viewerQuestion, mustCopyVisualGrammar, and forbiddenDrift.

Stop Conditions

  • Stop when required user intent, source evidence, or owned input artifacts are missing and guessing would change the result.

Handoff

  • For a grid or panel plan, preserve the decoded evidence in the requested layout before image generation.
  • Image generation -> image-batch-runner.
  • Video generation -> video-batch-runner; pass the useful decoded grammar as context, not as a second contract file.

Public Command Boundary

  • Choose the smallest matching command or workflow from the user input and run it directly.

  • This public skill is instruction-driven. Produce the artifact described by the workflow directly from the available evidence.

  • Do not use unpublished execution paths or local tools.

  • Requested tasks use existing PostPlus credits after the current price and balance are checked. Estimate-only requests do not execute. Stop on insufficient credits; do not recharge, buy a subscription, or repeat an uncertain paid operation.

Comments

Markdown supported