novel-art

Generates scene and narrative-prop art bibles with consistency anchors for AI short-drama production.

2.8k|363|Updated Aug 6, 2026
One-click install
npx skills add https://github.com/eternityspring/shuohao-skills --skill novel-art
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: novel-art
Source: https://github.com/eternityspring/shuohao-skills/tree/main/skills/novel-art
Command: npx skills add https://github.com/eternityspring/shuohao-skills --skill novel-art

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

AI-generated short dramas need environments and props that get regenerated dozens of times yet must look identical across episodes. This Skill turns a novel outline into a structured art bible (art.json) covering scenes and narrative props, with consistency anchors, lighting states, and English image prompts, all enforced by 11 deterministic quality gates instead of model self-checklists.

Core Features & Use Cases

  • Scene design sheets: design intent, 3-5 consistency anchors per scene, lighting-state prompts, and a variant mechanism (variantOf + changes) so derived scenes reuse the parent scene's assets.
  • Narrative prop sheets: dramatic function, state variants, scale references written into prompts, and white-background no-hands plates ready for compositing into shots.
  • Deterministic quality gates: 11 script-checked gates covering anchor counts, empty-scene negatives, English-only prompts, no character names (cross-checked against cast.json), prop scale phrases, and pure white backgrounds.
  • Use Case: Feed it the outline.json from novel-outline, run seed to prefill the scene and prop lists, fill in the design fields, validate against cast.json, optionally generate 16:9 reference sheets via codex's built-in $imagegen, and render a bilingual (zh/en) HTML report.

Quick Start

Ask the agent to build an art bible for your short drama from outline.json, for example: "Use novel-art to seed scenes and props from outline.json, fill the scene and prop designs, validate, and render the HTML report."

Frequently Asked Questions about novel-art

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create consistent scene designs for AI-generated video?

Define 3-5 consistency anchors per scene (recognizable features like a patched canopy or broken plank) plus lighting-state prompts, then validate them with the script's deterministic gates. The anchors become the checklist QC uses to verify generated shots have not drifted.

How to keep AI-generated props the same across episodes?

Treat each narrative prop as an asset with state variants (closed/open), a scale phrase written into the prompt (handheld/tabletop/furniture scale), and a pure white background plate with no hands. The validator blocks prompts missing the scale phrase or hand bans.

Does novel-art require an API key for image generation?

No API key is required. Image generation uses codex's built-in $imagegen with the local codex login; without codex the skill simply delivers prompts only and everything else works unchanged.

Can I use novel-art without the outline from novel-outline?

Yes. Without outline.json you skip the seed step and build the scene list manually from the source text or a handwritten list, following references/schema.md. Prop extraction from the raw text then follows references/prop-pass.md.

Why does validation fail on my scene prompts?

Common failures are anchors outside the 3-5 range, negative prompts that do not ban people, non-English prompt text, character names leaking into prompts, or a ghibli style whose negative prompt does not ban photorealistic. Run the checkup command to see exactly which of the 11 gates failed.

What are the limitations of the novel-art skill?

It only covers scenes and narrative props (typically 3-8 close-up, cross-episode, plot-bearing items); set dressing stays in scene anchors and one-off hand props are handled at shot level. It does not do storyboards, scripts, characters, or outlines, and is only tested on macOS with Node 24.