Skip to main content

​
Usage

vidjutsu check run --spec <file> --rules <rules>

​
Options

FlagRequiredDescription
--specYesPath to the spec file to validate
--rulesYesRules to enable. Comma-separated IDs or a JSON config object.
All rules are off by default. You must enable at least one.

​
Rules

RuleNameUse for
VL001Temporal ContinuityAll formats
VL002Subject ConsistencyAll formats
VL003Camera PhysicsB-roll, cinematic
VL004Audio AlignmentTalking-head, dialogue
VL005Provider CompatibilityAll formats
VL006Description QualityB-roll, cinematic
VL009Expression ContinuityTalking-head
VL010Audio NormalizationB-roll, music
VL011Prosody ControlTalking-head, dialogue
VL012Anti-EmphasisTalking-head, dialogue
VL013Talking Head StillnessTalking-head only

​
Examples

​
Comma-separated (enable by ID)

vidjutsu check run --spec ./brief.json --rules VL013,VL011,VL012

Checking spec with 3 rules...
✓ All checks passed

3/3 rules passed

​
JSON config (enable, disable, override severity)

vidjutsu check run --spec ./brief.json \
  --rules '{"VL013": true, "VL011": {"severity": "warning"}, "VL003": false}'

Checking spec with 3 rules...
✗ Failed checks:
  [warning] VL011: No prosody direction found in scene description

2/3 rules passed

​
Custom rules

Custom rules are plain-text strings stored per-client. They are not evaluated by the check endpoint — they’re evaluated by the agent layer where Claude is available. 
# List your custom rules
vidjutsu check rules list

# Save custom rules
vidjutsu check rules set "ai-reveal-required: Dialogue must contain a clear AI reveal,first-person-dialogue: All dialogue must be first-person"

​
Rate limit

Counts toward the daily check limit (100/day). Resets at 00:00 UTC; exceeding it returns HTTP 429. Custom rule CRUD is unmetered.