Install
$ agentstack add skill-wanshuiyin-aris-movie-director-comic-style-bible-lock ✓ scanned · ✓ verified — works with Claude Code, Cursor, and more.
Security review
✓ PassedNo issues found. Passed automated security review. · v0.1.0 How review works →
- ✓ Prompt-injection patterns
- ✓ Secret / credential exfiltration
- ✓ Dangerous shell & filesystem operations
- ✓ Untrusted network calls
- ✓ Known-malicious package signatures
What it can access
- ✓ Network access No
- ✓ Filesystem access No
- ✓ Shell / process execution No
- ✓ Environment & secrets No
- ✓ Dynamic code execution No
From automated source analysis of v0.1.0. “Used” means the capability is present in the source — more access means more to trust, not that it’s unsafe.
About
comic-style-bible-lock — the Style Bible as an Executable Gate Rubric (Phase 1 · S2)
The S2 step of [comic-author](../comic-author/SKILL.md): turn ART_BIBLE.md from a wall of taste adjectives into a machine-addressable convergence target. The bible is the single visual dialect that is (a) read verbatim into every bake prompt so each frame converges to the same look, and (b) read verbatim into every visual reviewer's prompt so the cross-model panel_gate scores style_consistency / identity_consistency against a ground-truth spec — not against the reviewer's vibe. The bible literally declares this of itself:
> style_consistency / identity_consistency 的字面定义就是"符合本文件",不是凭感觉。 > 无 ground-truth spec,跨模型 gate 会永远吐"style drift"却没有收敛方向。 > — examples/comic_m3_audit/ART_BIBLE.md, lines 3–5
That second line is the whole reason this skill exists. Without one source of truth a cross-model gate emits endless "style drift" with no convergence direction, and the film silently grows two visual dialects. This skill locks each dimension to a named anchor so the gate has an individually-addressable, source-pinned target instead of one prose blob — one visual dialect, never two.
ART_BIBLE.md (taste, user-approved, dated, probe-anchored)
│
▼
① bootstrap ── deterministic parse → ONE immutable style_anchor node per dimension
│ (palette · line · shading · two-world warm/cyber lighting · identity-lock
│ · text-mode · forbidden · by-design exceptions) + EXACT style_bible gate (6 dims ≥4, 5 vetoes)
▼
② validate ── deterministic lint (NO LLM): FORBIDDEN vocab + identity-conflict + world-mismatch
│ → called by every downstream author step BEFORE the text enters a bake prompt
▼
③ update ── (after ≥1 KEEP panel) Gemini-harvest recurring drift → APPEND-ONLY by-design exception anchors
(≥50% same-beat quorum, cross-model only) — never rewrites the baseline
Role
Compile, lock, and police the project's locked visual identity across the comic lifecycle. You own the 3-subcommand lifecycle — bootstrap (bible → immutable anchors + gate), validate (deterministic lint of candidate authoring text), update (cross-model drift-harvest into append-only exceptions) — and the EXACT style_bible gate below. You do not invent taste: every anchor traces to a user-approved, dated, probe-anchored line in ART_BIBLE.md. If the bible is missing you auto-bootstrap a scaffold and escalate to the user for approval; if it exists and is locked you leave it locked and only ever add by-design exceptions. The convergence guarantee — "one visual dialect, never two" — is enforced here or nowhere.
Constants
- BIBLE =
/ART_BIBLE.md— the source of truth; version-stamped + dated + project-pinned
(real: version art-bible/1.0 · 锁定 2026-06-08 · 项目 aris_comic_v1).
- ANCHOR_DIR =
/wiki/nodes/— onestyle:.jsonper dimension (node_type: style_anchor). - DRIFT_REVIEWER =
mcp__gemini__analyzeFile(auto-gemini-3) — the visual drift reviewer forupdate.
Cross-model independence: the executor (Claude) only aggregates Gemini's JSON; it never judges drift itself.
- QUORUM =
(n+1)//2(≥50%) of the same-beat multi-panel drift samples must flag a dimension before an
exception is written (bump to 75% if drift-from-noise floods). One noisy panel must not mutate the bible.
- MAXPANELSPER_UPDATE = 6 (cost cap on the Gemini drift pass).
- GATE = the deterministic
style_biblegate (6 dims ≥4 + 5 hard vetoes) — **rule-check, NO cross-model
gate** (the bible IS the rubric the other skills' cross-model gates consume; here we only certify it compiles).
- IMMUTABLE BASELINE —
bootstrapanchors and the §0–§7 spine are locked.updateonly appends
exception anchors; pivoting the baseline = a fresh bootstrap in a NEW project dir, never an in-place edit (the cross-model gate must always compare new output against the ORIGINAL anchors). See acceptance-gate (locked=immutable).
The §0–§7 section spine bootstrap asserts (the worked example's structure)
bootstrap requires the bible to carry this exact spine — each section is the source of one or more anchors. Copy examples/comic_m3_audit/ART_BIBLE.md as the shape:
| § | Section | What it pins | Anchor(s) emitted | |---|---|---|---| | §0 | 总风格声明 (overall style) | register, anchored to a NAMED probe image + dated user approval (real: = 批准的 probe/S02_codexgen_a01.png 那个程度); image-rendering: pixelated + integer-multiple scaling | style:overall_register | | §0.5 | 双世界色调 (two-world palette) | warm 人间 vs dark 赛博 (dark_navy_void #0A0E27), with the baked gate instruction 冷暖是 by-design 的,不是漂移 | style:palette_warm_world, style:palette_dark_world, style:by_design_warm_cyber | | §1 | 角色身份锁 (identity lock) | authority-ref pointer (duo_canonical_ref_v001.png) + per-character hex table + the 铁律 | style:identity_executor, style:identity_reviewer, style:identity_authority_ref | | §2 | 主角 chibi (researcher) | researcher chibi spec (glasses/hair/backpack, same person across panels) | style:researcher_chibi | | §3 | 线条 / 阴影 / 色阶 | hard-edge pixels, no smooth gradient on character/foreground + the reviewer-calibrated background-atmosphere carve-out (dated 2026-06-08) | style:line_shading | | §4 | UI / 叙事色板 | overlay token palette (warningred / amber / invariantpurple / successgreen / darknavy_void) | style:ui_palette | | §6 | 文字 / 气泡 | text modes html \| baked \| code + the decision history (incl. the explicit PENDING duel) | style:text_mode_contract | | §6.5 | 环境叙事密度 | density target image, marked quality-gradient-NOT-hard-reject (target cal_S12_a01) | style:env_density (hard_reject: false) | | §7 | FORBIDDEN | the explicit ban list (incl. the voxel ban after gemini found flat-2D↔voxel drift) | style:forbidden |
Procedure
① bootstrap — compile the bible into immutable anchors (+ certify the gate)
Run once per project, before any other S-step authors text. Re-run is idempotent (overwrites byte-identical).
- Assert the bible exists. If
/ART_BIBLE.mdis missing → auto-bootstrap: write a §0–§7
scaffold from the table above with every taste field a TODO(user-approve) placeholder, append a log line, and STOP — escalate to the user for the §0 probe-image + §0.5 world choice + §1 hex table + §6 text-mode approval. Never fabricate a probe image, a hex, or a user-approval date. (exit 2)
- Assert version + lock + project stamp + user-approval dates. Grep for the
version art-bible/…line,
the 锁定 lock, the project id, and at least one dated user-attributed approval line ((用户 …)). Any missing → veto (see gate); do not proceed.
- Assert the §0–§7 spine compiles. Grep each section header from the table above. A missing §0 (no probe +
approval), §0.5 (no by-design instruction), §1 (no authority ref / hex table), §6 (no text-mode), or §7 (no FORBIDDEN list) is a hard veto.
- Deterministic parse → ONE
style_anchornode per dimension. Regex-grab the §0.5 palette block, the §1
hex table, the §3/§4 rules, the §6 mode list, the §7 FORBIDDEN list, and the §0.5 by-design exceptions. Emit exactly the anchors in the table's right column. Node shape (matches schemas/node_schema.json → style_anchor, payload required dimension, value, source, locked): ``json { "node_id": "style:identity_executor", "node_type": "style_anchor", "title": "identity-lock — executor (blue hoodie, brown hair, NO beard)", "status": "locked", "created_at": "2026-06-08T00:00:00Z", "tags": ["style_anchor", "baseline", "identity"], "payload": { "dimension": "identity:executor", "value": {"hoodie": "#1D4684", "hair": "#925935", "beard": false, "iron_law": "executor 永远蓝+棕发+无须;L/R 位置可变,颜色/胡子/体型轮廓不可变"}, "source": "ART_BIBLE.md §1 (authority duo_canonical_ref_v001.png)", "locked": true } } ` Every anchor sets status: "locked", payload.locked: true, payload.source = the exact §-section it came from, and tags include ["styleanchor","baseline"]. The §6.5 density anchor additionally carries payload.value.hardreject: false` (quality gradient, NOT a hard reject).
- Run the EXACT
style_biblegate (below). All 6 dims ≥4 and no veto → write the anchors, append a
line to /wiki/log.md, print {anchors_written, n_anchors, gate}. Any dim ` — deterministic lint (NO LLM) Called by every downstream author step (intent / outline / storyboard / blueprint / prompt) BEFORE the text is allowed into a bake prompt. Pure Python, no model call — fast, reproducible, fork-proof.
- FORBIDDEN-vocab scan of §7 (whole-word,
re.IGNORECASE): any hit on the §7 ban list (voxel 立体块 /
写实照片质感 / non-canonical mascot colors / 非整数缩放 / smooth gradient on a character or solid foreground prop) → passes=false, return forbidden_hits[].
- Identity-conflict lint against
style:identity_*: flag text that puts the reviewer without a beard,
the executor with a beard, or any mascot color outside {blue,green,brown,black} → passes=false.
- World-mismatch lint against
style:by_design_warm_cyber: flag only mis-colored worlds — "a warm
scene gone cold" or "a digital/technical artifact gone warm" — and NEVER flag the warm↔dark split itself (it is by-design). This is the concrete embodiment of intended-variation ≠ drift.
- (Optional, mostly DROPPED for us) over-prompt / quality-padding guard — the video source banned camera/
lighting/8K/hyperrealistic vocab because it hijacks Pippit's per-beat decomposition and triggers a silent model downgrade. codex image_gen has no per-beat decomposition to hijack, so this whole category DROPs by default; keep only a thin quality-padding check if a baked title ever shows the over-prompt signature.
- Conservative-refuse rule: prefer a false-positive (force a human glance) over letting an
identity/world/forbidden violation slip into a paid bake. Merge → passes_all; exit 0 (clean) / 1 (fail).
③ update — Gemini-harvest drift into append-only by-design exceptions
Run only after ≥1 KEEP panel exists (else exit 2). This folds the bible into the spiral's wiki memory — recurring, intended deviations become written exceptions; one-off noise does not.
- Gather the most-recent KEEP panel images of a beat, capped at
MAX_PANELS_PER_UPDATE, into a manifest.
(Image-panels swap the video source's "frames" for PNG panels — one image per panel, so the quorum is across panels in a beat, not within-clip frames.)
- Per panel, call
mcp__gemini__analyzeFile(auto-gemini-3) extracting ONLY, in strict JSON, with the
baseline anchor values pasted inline: color_palette (3–5 hex), lighting (dir / hardness / temp), subjects_present, subjects_absent_but_expected, drift_from_bible (item-by-item deviation vs each baseline anchor), safety_flags (faces / logos / celebrity). Gemini, not Claude, is the visual judge — if Gemini-MCP is down → exit 3, NEVER fall back to a Claude-only read (that violates cross-model independence).
- Aggregate (Claude's only job here). A per-beat exception locks only when a dimension's drift is
reported in ≥ QUORUM panels of the SAME beat. Then: write a NEW style_anchor (tags: ["style_anchor","exception"], payload.value adds support_frames/total_frames, payload.locked: true), and add a uses_style_anchor edge to wiki/edges.jsonl in the exact {src, dst, type} shape cli/validate_wiki.py enforces (line 149: every edge needs src/dst/type; line 153: type ∈ EDGE_TYPES; both endpoints must resolve to a wiki node_id or a comic.json panel anchor panels..wiki_node_id). Endpoints: src = a representative KEEP panel of the beat addressed by its legal panel anchor panel: (e.g. panel:s12_aris_comic_v1, copied from comic.json panels..wiki_node_id — never a `, which is not a legal node_id prefix; the only legal prefixes are intent|style|outline|asset|storyboard|panel|blueprint|prompt|motif|cont|attempt|review|decision|fail), dst = the new style: exception node. Carry the evidence on extra (validator-ignored) keys: `json {"src": "panel:s12_aris_comic_v1", "dst": "style:s12_env_density_exception", "type": "uses_style_anchor", "evidence": "drift in c/n panels", "reviewer": "Gemini"} ` Then **APPEND** a line to the bible's ## Per-beat exceptions section: - **** — : (observed in c/n panels, Gemini)`.
- Never rewrite the baseline.
updateis append-only. Log the append; print{exceptions_added, anchors}.
EXACT gate — style_bible (ported verbatim from the aris_movie source · deterministic, NO cross-model gate)
bootstrap certifies the compiled bible against this gate. It is a deterministic rule-check — there is no cross-model judge here, because the bible is the rubric every other skill's cross-model gate consumes; this gate only proves the rubric itself is complete and conflict-free.
Dimensions — ALL must score ≥4:
anchor_completeness— every §0–§7 dimension compiled to an addressablestyle_anchornode (no prose-only blob).authority_ref_resolved— the §1 identity authority ref (duo_canonical_ref_v001.png) exists on disk and is pointed at.identity_lock_specificity— per-character hex + beard + silhouette iron-law is concrete, not adjectives
(executor 蓝+棕发+无须 / reviewer 绿+黑发+有须; L/R free; color/beard/silhouette immutable).
text_mode_contract— §6 declares the mode vocabulary (html | baked | code) AND **every observed
text_mode is licensed by an explicit §6 clause** (the checkable rule, NOT a global equality): read comic.json defaults.text_mode (and movie.project.json.text_mode_default) plus every panels..text_mode, collect the distinct observed modes, and require each one to be permitted by a named §6 clause. (Scores .json. node_id prefix is style: (per the schema's id pattern). The payload's required fields are exactly dimension, value, source, locked:
dimension— the locked axis (e.g.palette:dark_world,identity:reviewer,line_shading,forbidden,
by_design:warm_cyber, text_mode, env_density).
value— the concrete spec (hexes / rule text / the by-design instruction / the mode set / the ban list).source— the exactART_BIBLE.md §Nthe value traces to (un-sourced anchor = refuse, never fabricate).locked—truefor baseline anchors (immutable) and exception anchors alike.- baseline
status: "locked",tags ⊇ ["style_anchor","baseline"]; exception anchors add theexception
tag + support_frames/total_frames and an incoming uses_style_anchor edge in wiki/edges.jsonl written {src: "panel:", dst: "style:", type: "uses_style_anchor"} (a legal panel anchor → the exception node; src/dst/type + resolvable endpoints, per cli/validate_wiki.py).
Two engine contracts this skill upholds (fail-closed)
The bible is what makes the [comic-author](../comic-author/SKILL.md) engine contracts enforceable, so the gate certifies them at the bible layer:
- Every panel needs a
condition.content_svg— the §0–§7 dialect is what every deterministic blueprint is
rendered in; the bible must be lockable so a blueprint has a single style to instantiate (no content_svg: null; the engine rejects it).
- A baked figure-panel needs
condition.expected_literals— §6's `t
…
Source & license
This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.
- Author: wanshuiyin
- Source: wanshuiyin/ARIS-Movie-Director
- License: MIT
- Homepage: https://wanshuiyin.github.io/ARIS-Movie-Director/comic/
Install and usage instructions live in the source repository linked above.
Reviews
No reviews yet — be the first.
Write a review
Versions
- v0.1.0 Imported from the upstream source.