how-to-make-script

Category: Docs & Knowledge | Uploader: XucroYuri | Downloads: 0 | Version: v1.0（Latest）

Root orchestration skill for screenplay creation. Routes requests by intent, medium, stage, output, and constraints, then loads the minimum necessary protocols, rubrics, and knowledge atoms.

Changelog: Source: GitHub https://github.com/XucroYuri/how-to-make-script

Directory Structure

Current level: tree/main/

📁 .github/
- 📁 DISCUSSION_TEMPLATE/
  - 📄 general.yml 1.6 KB
  - 📄 ideas.yml 2.0 KB
  - 📄 q-a.yml 1.9 KB
  - 📄 show-and-tell.yml 2.0 KB
- 📁 ISSUE_TEMPLATE/
  - 📄 01-knowledge-challenge.yml 2.7 KB
  - 📄 02-route-failure.yml 2.1 KB
  - 📄 03-field-evidence.yml 2.0 KB
  - 📄 04-learning-friction.yml 1.9 KB
  - 📄 05-community-process.yml 1.6 KB
  - 📄 06-scope-correction.yml 2.4 KB
  - 📄 config.yml 1.5 KB
- 📁 workflows/
  - 📄 ci.yml 1.5 KB
- 📄 CODEOWNERS 13 B
- 📄 dependabot.yml 211 B
- 📄 pull_request_template.md 1.4 KB
📁 docs/
- 📁 assets/
  - 📄 readme-hero-zh.svg 8.0 KB
  - 📄 readme-hero.svg 8.3 KB
- 📁 shared/
  - 📄 agent-tiers.md 1.3 KB
  - 📄 screenplay-agent-roles.md 2.8 KB
- 📄 adaptive-quality-checking-zh.md 3.2 KB
- 📄 adaptive-quality-checking.md 2.8 KB
- 📄 agent-skill-evaluation-zh.md 6.0 KB
- 📄 agent-skill-evaluation.md 6.7 KB
- 📄 agent-skill-review-2026-04-zh.md 3.0 KB
- 📄 agent-skill-review-2026-04.md 3.1 KB
- 📄 architecture-zh.md 5.8 KB
- 📄 architecture.md 6.2 KB
- 📄 bilingual-authoring.md 2.9 KB
- 📄 canonical-term-policy-zh.md 4.2 KB
- 📄 canonical-term-policy.md 4.9 KB
- 📄 community-feedback-loop-zh.md 5.3 KB
- 📄 community-feedback-loop.md 5.4 KB
- 📄 community-operations-zh.md 4.4 KB
- 📄 community-operations.md 4.6 KB
- 📄 community-triage-loop-zh.md 5.6 KB
- 📄 community-triage-loop.md 5.8 KB
- 📄 content-model-zh.md 6.3 KB
- 📄 content-model.md 7.2 KB
- 📄 context-loading-policy-zh.md 5.1 KB
- 📄 context-loading-policy.md 5.1 KB
- 📄 epistemic-stance-zh.md 2.6 KB
- 📄 epistemic-stance.md 2.4 KB
- 📄 exploration-vs-review.md 2.4 KB
- 📄 expression-lens-policy-zh.md 3.0 KB
- 📄 expression-lens-policy.md 2.9 KB
- 📄 how-to-create-a-screenplay-research-zh.md 11.0 KB
- 📄 how-to-create-a-screenplay-research.md 10.5 KB
- 📄 multi-agent-screenplay-architecture-zh.md 5.3 KB
- 📄 multi-agent-screenplay-architecture.md 5.6 KB
- 📄 multilingual-visual-language-layer-zh.md 1.9 KB
- 📄 multilingual-visual-language-layer.md 2.1 KB
- 📄 private-reference-distillation-policy-zh.md 1.9 KB
- 📄 private-reference-distillation-policy.md 2.0 KB
- 📄 progressive-disclosure-policy-zh.md 2.2 KB
- 📄 progressive-disclosure-policy.md 2.4 KB
- 📄 project-surface-architecture-zh.md 2.4 KB
- 📄 project-surface-architecture.md 2.2 KB
- 📄 reality-lenses-zh.md 4.4 KB
- 📄 reality-lenses.md 5.0 KB
- 📄 reference-project-lessons-zh.md 4.6 KB
- 📄 reference-project-lessons.md 5.1 KB
- 📄 repository-hygiene.md 1.4 KB
- 📄 roadmap-zh.md 11.0 KB
- 📄 roadmap.md 8.4 KB
- 📄 scenario-atlas-zh.md 11.4 KB
- 📄 scenario-atlas.md 15.3 KB
- 📄 screenplay-to-video-bridge-zh.md 1.5 KB
- 📄 screenplay-to-video-bridge.md 1.6 KB
- 📄 semantic-governance-zh.md 3.1 KB
- 📄 semantic-governance.md 3.2 KB
- 📄 socratic-question-backlog-en.md 8.2 KB
- 📄 socratic-question-backlog.md 8.6 KB
- 📄 source-map-real-world.md 5.3 KB
- 📄 source-map-reference-projects.md 3.6 KB
- 📄 source-map-screenplay-creation-research.md 8.3 KB
- 📄 source-map-screenplay-methods-zh.md 4.0 KB
- 📄 source-map-screenplay-methods.md 4.3 KB
- 📄 source-map-team-workflows.md 4.1 KB
- 📄 subagent-library-architecture-zh.md 4.1 KB
- 📄 subagent-library-architecture.md 3.9 KB
- 📄 team-operating-modes-zh.md 7.2 KB
- 📄 team-operating-modes.md 7.7 KB
📁 examples/
- 📁 agent/
  - 📄 e2e-journeys.json 5.2 KB
  - 📄 fixtures.json 52.8 KB
  - 📄 nl-routing-bench.json 11.8 KB
  - 📄 quickstart.json 851 B
- 📁 failures/
  - 📄 fail-001-premise-drift.md 1.1 KB
  - 📄 fail-002-voice-collapse.md 926 B
  - 📄 fail-003-missing-parenthetical.md 878 B
  - 📄 fail-004-av-cue-omission.md 814 B
  - 📄 fail-005-naturalness-drift.md 961 B
  - 📄 README.md 1.6 KB
- 📁 golden/
  - 📁 commercial-launch/
    
    📄 artifact.md 846 B
    
    📄 request.md 134 B
    
    📄 route.json 157 B
  - 📁 feature-drama/
    
    📄 artifact.md 1.1 KB
    
    📄 request.md 178 B
    
    📄 route.json 142 B
  - 📁 feature-scene/
    
    📄 artifact.md 1.2 KB
    
    📄 request.md 215 B
    
    📄 route.json 137 B
  - 📁 feature-screenplay/
    
    📄 artifact.md 2.6 KB
    
    📄 request.md 254 B
    
    📄 route.json 147 B
  - 📁 interactive-quest/
    
    📄 artifact.md 993 B
    
    📄 request.md 157 B
    
    📄 route.json 176 B
- 📁 human/
  - 📄 commercial-brief-to-script.md 267 B
  - 📄 interactive-choice-design.md 351 B
  - 📄 narrative-development.md 360 B
- 📁 reference-packs/
  - 📄 character-voice-reference-pack.md 4.5 KB
  - 📄 commercial-pattern-pack.md 7.3 KB
  - 📄 interactive-pattern-pack.md 6.0 KB
  - 📄 narrative-pattern-pack.md 14.2 KB
  - 📄 opening-pattern-pack.md 3.7 KB
  - 📄 project-surface-map-pack.md 2.6 KB
  - 📄 reactive-comedy-pattern-pack.md 2.4 KB
  - 📄 screen-to-video-bridge-pack.md 1.4 KB
  - 📄 subagent-cast-pack.md 3.8 KB
  - 📄 visual-language-pack.md 2.2 KB
📁 knowledge/
- 📁 00-ontology/
  - 📄 boundary-taxonomy.md 2.4 KB
  - 📄 constraint-taxonomy.md 9.9 KB
  - 📄 epistemic-policy.md 1.8 KB
  - 📄 media-taxonomy.md 2.2 KB
  - 📄 overview.md 2.5 KB
  - 📄 project-surface-taxonomy.md 5.1 KB
  - 📄 reality-lens-taxonomy.md 2.7 KB
  - 📄 scenario-taxonomy.md 4.7 KB
  - 📄 stage-taxonomy.md 1.8 KB
  - 📄 subagent-taxonomy.md 3.7 KB
  - 📄 team-collaboration-taxonomy.md 3.9 KB
- 📁 10-foundations/
  - 📄 ka-adaptive-quality-lens-selection.md 2.9 KB
  - 📄 ka-animation-story-trust-loop.md 2.5 KB
  - 📄 ka-archive-literacy.md 3.1 KB
  - 📄 ka-audience-need-state.md 3.1 KB
  - 📄 ka-beat-carrier-selection.md 2.4 KB
  - 📄 ka-boundary-first-guidance.md 2.7 KB
  - 📄 ka-bounded-context-loading.md 2.9 KB
  - 📄 ka-brand-content-studio-loop.md 2.5 KB
  - 📄 ka-canonical-packet-assembly.md 3.0 KB
  - 📄 ka-causality-chain.md 2.7 KB
  - 📄 ka-character-arc.md 2.7 KB
  - 📄 ka-character-drive-quartet.md 2.4 KB
  - 📄 ka-character-voice-consistency.md 3.5 KB
  - 📄 ka-command-artifact-mapping.md 3.0 KB
  - 📄 ka-commissioning-fit.md 3.3 KB
  - 📄 ka-conflict-pressure.md 2.7 KB
  - 📄 ka-context-corrosion-signals.md 2.7 KB
  - 📄 ka-contract-first-quality-gating.md 2.9 KB
  - 📄 ka-convergence-owner-discipline.md 2.9 KB
  - 📄 ka-creative-pluralism.md 2.9 KB
  - 📄 ka-cultural-aesthetic-registers.md 3.6 KB
  - 📄 ka-dissent-preservation-loop.md 2.9 KB
  - 📄 ka-divergence-convergence-loop.md 2.8 KB
  - 📄 ka-dual-track-rhythm.md 3.1 KB
  - 📄 ka-exploration-review-separation.md 2.9 KB
  - 📄 ka-false-logline-warning.md 2.7 KB
  - 📄 ka-false-universal-warning.md 2.6 KB
  - 📄 ka-feature-development-pod.md 2.5 KB
  - 📄 ka-feedback-subjectivity-management.md 3.0 KB
  - 📄 ka-genre-pack-factorization.md 2.4 KB
  - 📄 ka-handoff-contract-discipline.md 3.2 KB
  - 📄 ka-handoff-packet-discipline.md 2.9 KB
  - 📄 ka-hard-gate-soft-score-separation.md 2.6 KB
  - 📄 ka-human-checkpoint-gates.md 3.1 KB
  - 📄 ka-interactive-branch-lab.md 2.5 KB
  - 📄 ka-ip-voice-continuity.md 3.3 KB
  - 📄 ka-metrics-handoff-compression.md 2.6 KB
  - 📄 ka-multilingual-visual-vocabulary.md 4.0 KB
  - 📄 ka-parallel-lane-governance.md 3.1 KB
  - 📄 ka-phase-entrypoint-handoff.md 2.9 KB
  - 📄 ka-platform-attention-economy.md 3.2 KB
  - 📄 ka-process-node-specialization.md 3.2 KB
  - 📄 ka-prompt-delegation-levels.md 3.2 KB
  - 📄 ka-reference-expansion-balance.md 2.6 KB
  - 📄 ka-reference-pattern-usage.md 3.0 KB
  - 📄 ka-reference-persona-governance.md 3.7 KB
  - 📄 ka-review-lens-isolation.md 2.7 KB
  - 📄 ka-room-artifact-ladder.md 3.2 KB
  - 📄 ka-scenario-factorization.md 4.6 KB
  - 📄 ka-scope-correction.md 3.0 KB
  - 📄 ka-screenplay-lens-stacking.md 3.3 KB
  - 📄 ka-screenplay-to-video-boundary.md 3.6 KB
  - 📄 ka-screenwriting-deliberate-practice.md 2.9 KB
  - 📄 ka-screenwriting-history-shift.md 3.1 KB
  - 📄 ka-script-as-coordination-artifact.md 3.0 KB
  - 📄 ka-serial-arc-budgeting.md 3.1 KB
  - 📄 ka-showrunner-room-cadence.md 2.6 KB
  - 📄 ka-source-of-truth-runtime-split.md 3.0 KB
  - 📄 ka-story-goal.md 2.9 KB
  - 📄 ka-story-memory-checkpoint.md 3.9 KB
  - 📄 ka-structure-family-selection.md 2.6 KB
  - 📄 ka-subagent-cast-composition.md 3.2 KB
  - 📄 ka-subagent-context-budgeting.md 3.2 KB
  - 📄 ka-targeted-recheck-loop.md 2.7 KB
  - 📄 ka-team-topology-selection.md 3.3 KB
  - 📄 ka-theme-pressure.md 2.7 KB
  - 📄 ka-two-stage-review-loop.md 3.1 KB
  - 📄 ka-viewer-inference-guidance.md 3.2 KB
  - 📄 ka-writer-development-loop.md 3.2 KB
- 📁 20-workflows/
  - 📄 wp-audience-fit-note.md 2.9 KB
  - 📄 wp-boundary-map.md 2.7 KB
  - 📄 wp-character-world.md 2.9 KB
  - 📄 wp-commercial-script.md 2.6 KB
  - 📄 wp-context-loading-plan.md 3.6 KB
  - 📄 wp-development-brief.md 2.9 KB
  - 📄 wp-dialogue-polish.md 2.3 KB
  - 📄 wp-expert-subagent-cast.md 3.7 KB
  - 📄 wp-genre-adaptation.md 2.7 KB
  - 📄 wp-idea-discovery.md 2.6 KB
  - 📄 wp-interactive-branch-map.md 2.6 KB
  - 📄 wp-logline-premise.md 2.8 KB
  - 📄 wp-path-options.md 2.8 KB
  - 📄 wp-pattern-reference-pack.md 2.9 KB
  - 📄 wp-project-surface-map.md 3.6 KB
  - 📄 wp-quality-gate-report.md 4.2 KB
  - 📄 wp-research-background-map.md 3.3 KB
  - 📄 wp-rewrite-doctor.md 2.5 KB
  - 📄 wp-scene-writing.md 3.9 KB
  - 📄 wp-scope-correction.md 2.9 KB
  - 📄 wp-screen-to-video-brief.md 4.1 KB
  - 📄 wp-story-memory-checkpoint.md 3.4 KB
  - 📄 wp-structure-beat-outline.md 3.7 KB
  - 📄 wp-subagent-dispatch-plan.md 3.6 KB
  - 📄 wp-team-workflow-blueprint.md 4.1 KB
  - 📄 wp-visual-language-pack.md 3.9 KB
  - 📄 wp-voice-style-guide.md 4.0 KB
  - 📄 wp-writer-development-path.md 2.8 KB
- 📁 30-craft/
  - 📄 ka-capability-friction-balance.md 2.1 KB
  - 📄 ka-cinematic-prose-register.md 3.7 KB
  - 📄 ka-dialogue-subtext.md 2.6 KB
  - 📄 ka-embodied-text-pressure.md 3.2 KB
  - 📄 ka-exposition-control.md 2.6 KB
  - 📄 ka-long-script-batch-planning.md 2.3 KB
  - 📄 ka-opening-job-selection.md 2.4 KB
  - 📄 ka-pacing-rhythm.md 2.7 KB
  - 📄 ka-reactive-comedy-loop.md 2.4 KB
  - 📄 ka-register-adaptation.md 3.4 KB
  - 📄 ka-rewrite-diagnosis.md 2.7 KB
  - 📄 ka-scene-function.md 2.6 KB
  - 📄 ka-source-span-traceability.md 2.5 KB
  - 📄 ka-triggered-behavior-profile.md 2.3 KB
  - 📄 ka-verbal-rhythm.md 4.1 KB
  - 📄 ka-video-generation-shot-economy.md 3.0 KB
  - 📄 ka-visible-asset-grounding.md 2.5 KB
- 📁 40-media/
  - 📄 ka-medium-animation.md 2.6 KB
  - 📄 ka-medium-branching-interactive.md 2.6 KB
  - 📄 ka-medium-branded-film.md 2.6 KB
  - 📄 ka-medium-commercial.md 2.5 KB
  - 📄 ka-medium-episode.md 2.9 KB
  - 📄 ka-medium-feature-film.md 2.5 KB
  - 📄 ka-medium-game-narrative.md 2.6 KB
  - 📄 ka-medium-short-drama.md 2.5 KB
  - 📄 ka-medium-shortform-video.md 2.5 KB
- 📁 50-genre/
  - 📄 ka-genre-comedy.md 2.7 KB
  - 📄 ka-genre-romance.md 2.5 KB
  - 📄 ka-genre-thriller.md 2.4 KB
- 📁 60-rubrics/
  - 📄 rb-adaptation.md 2.1 KB
  - 📄 rb-audience-fit.md 2.0 KB
  - 📄 rb-boundary-map.md 2.0 KB
  - 📄 rb-character-world.md 2.0 KB
  - 📄 rb-commercial-script.md 2.0 KB
  - 📄 rb-context-loading-plan.md 2.1 KB
  - 📄 rb-development-brief.md 1.9 KB
  - 📄 rb-dialogue.md 3.2 KB
  - 📄 rb-expert-subagent-cast.md 2.7 KB
  - 📄 rb-interactive-branch-map.md 2.1 KB
  - 📄 rb-learning-path.md 1.8 KB
  - 📄 rb-logline.md 2.5 KB
  - 📄 rb-outline.md 2.6 KB
  - 📄 rb-path-options.md 2.0 KB
  - 📄 rb-pattern-reference-pack.md 2.2 KB
  - 📄 rb-project-surface-map.md 2.6 KB
  - 📄 rb-quality-gate-report.md 2.6 KB
  - 📄 rb-research-background-map.md 2.5 KB
  - 📄 rb-rewrite-report.md 2.1 KB
  - 📄 rb-scene-draft.md 3.4 KB
  - 📄 rb-scope-correction.md 2.2 KB
  - 📄 rb-screen-to-video-brief.md 2.9 KB
  - 📄 rb-screenplay-draft.md 2.4 KB
  - 📄 rb-story-memory-checkpoint.md 2.2 KB
  - 📄 rb-subagent-dispatch-plan.md 2.8 KB
  - 📄 rb-team-workflow-blueprint.md 2.5 KB
  - 📄 rb-visual-language-pack.md 2.8 KB
  - 📄 rb-voice-style-guide.md 2.7 KB
- 📁 70-case-studies/
  - 📄 commercial-launch-note.md 1.3 KB
  - 📄 feature-drama-note.md 1.3 KB
  - 📄 interactive-quest-note.md 1.3 KB
📁 references/
- 📄 agent-team-roles.json 7.7 KB
- 📄 background-bundles.json 2.1 KB
- 📄 canonical-term-register.json 3.2 KB
- 📄 check-lens-matrix.json 9.6 KB
- 📄 community-label-taxonomy.json 3.6 KB
- 📄 constraint-key-register.json 2.8 KB
- 📄 context-loading-modes.md 5.1 KB
- 📄 discussion-surface-map.json 1.5 KB
- 📄 expert-subagent-library.json 20.9 KB
- 📄 expression-lens-triggers.md 5.0 KB
- 📄 id-policy.md 425 B
- 📄 output-format-contracts.json 1.9 KB
- 📄 output-format-contracts.md 2.8 KB
- 📄 registry-format.md 603 B
- 📄 router-matrix.json 16.6 KB
- 📄 routing-policy.md 5.3 KB
- 📄 scenario-taxonomy.json 32.3 KB
- 📄 skill-directory.md 4.6 KB
- 📄 subagent-topology-matrix.json 5.6 KB
- 📄 supported-outputs.md 3.6 KB
- 📄 taxonomy.md 2.3 KB
- 📄 team-mode-matrix.json 7.8 KB
- 📄 team-workflow-modes.json 9.7 KB
📁 schemas/
- 📄 background-bundle.schema.json 1.4 KB
- 📄 evaluation-rubric.schema.json 1.1 KB
- 📄 example-fixture.schema.json 843 B
- 📄 knowledge-atom.schema.json 1.5 KB
- 📄 output-format-contracts.schema.json 1.8 KB
- 📄 skill-manifest.schema.json 1.6 KB
- 📄 workflow-protocol.schema.json 1.2 KB
📁 scripts/
- 📄 __init__.py 78 B
- 📄 check_background_bundles.py 3.9 KB
- 📄 check_canonical_terms.py 2.4 KB
- 📄 check_community_surfaces.py 4.6 KB
- 📄 check_forbidden_paths.py 2.6 KB
- 📄 check_golden_artifact_formats.py 10.0 KB
- 📄 check_links.py 1.3 KB
- 📄 check_loading_budget.py 3.2 KB
- 📄 check_nl_routing.py 4.3 KB
- 📄 check_question_todos.py 2.5 KB
- 📄 check_route_overlaps.py 1.8 KB
- 📄 check_routes.py 3.6 KB
- 📄 check_semantic_consistency.py 10.2 KB
- 📄 check_subagent_registries.py 5.3 KB
- 📄 generate_index.py 9.1 KB
- 📄 lib.py 5.6 KB
- 📄 run_fixture_suite.py 2.1 KB
- 📄 validate_assets.py 5.2 KB
📁 skills/
- 📁 audience-insight/
  - 📄 manifest.json 1.1 KB
  - 📄 SKILL.md 974 B
- 📁 boundary-mapping/
  - 📄 manifest.json 1.1 KB
  - 📄 SKILL.md 856 B
- 📁 character-world/
  - 📄 manifest.json 908 B
  - 📄 SKILL.md 1.0 KB
- 📁 commercial-script/
  - 📄 manifest.json 1.2 KB
  - 📄 SKILL.md 950 B
- 📁 context-governor/
  - 📄 manifest.json 1.1 KB
  - 📄 SKILL.md 1.9 KB
- 📁 development-strategy/
  - 📄 manifest.json 1.2 KB
  - 📄 SKILL.md 933 B
- 📁 dialogue-subtext/
  - 📄 manifest.json 954 B
  - 📄 SKILL.md 901 B
- 📁 expert-subagent-casting/
  - 📄 manifest.json 1.5 KB
  - 📄 SKILL.md 1.4 KB
- 📁 genre-adaptation/
  - 📄 manifest.json 1.2 KB
  - 📄 SKILL.md 941 B
- 📁 idea-discovery/
  - 📄 manifest.json 1015 B
  - 📄 SKILL.md 841 B
- 📁 interactive-branching/
  - 📄 manifest.json 1000 B
  - 📄 SKILL.md 762 B
- 📁 logline-premise/
  - 📄 manifest.json 806 B
  - 📄 SKILL.md 942 B
- 📁 path-exploration/
  - 📄 manifest.json 1.1 KB
  - 📄 SKILL.md 893 B
- 📁 pattern-reference/
  - 📄 manifest.json 1.3 KB
  - 📄 SKILL.md 1.2 KB
- 📁 project-surface-design/
  - 📄 manifest.json 1.3 KB
  - 📄 SKILL.md 1.6 KB
- 📁 quality-gating/
  - 📄 manifest.json 1.4 KB
  - 📄 SKILL.md 1.3 KB
- 📁 research-background/
  - 📄 manifest.json 1.3 KB
  - 📄 SKILL.md 1.5 KB
- 📁 rewrite-doctor/
  - 📄 manifest.json 841 B
  - 📄 SKILL.md 946 B
- 📁 scene-writing/
  - 📄 manifest.json 1.1 KB
  - 📄 SKILL.md 1.4 KB
- 📁 scope-correction/
  - 📄 manifest.json 1.1 KB
  - 📄 SKILL.md 1.1 KB
- 📁 screen-to-video-bridge/
  - 📄 manifest.json 1.4 KB
  - 📄 SKILL.md 1.8 KB
- 📁 story-memory-checkpoint/
  - 📄 manifest.json 1.1 KB
  - 📄 SKILL.md 1.4 KB
- 📁 structure-beat/
  - 📄 manifest.json 986 B
  - 📄 SKILL.md 1.2 KB
- 📁 subagent-dispatch-design/
  - 📄 manifest.json 1.5 KB
  - 📄 SKILL.md 1.1 KB
- 📁 team-orchestration/
  - 📄 manifest.json 1.6 KB
  - 📄 SKILL.md 1.3 KB
- 📁 team-workflow-design/
  - 📄 manifest.json 1.5 KB
  - 📄 SKILL.md 1.4 KB
- 📁 visual-language/
  - 📄 manifest.json 1.2 KB
  - 📄 SKILL.md 1.5 KB
- 📁 voice-style-calibration/
  - 📄 manifest.json 1.3 KB
  - 📄 SKILL.md 1.1 KB
- 📁 writer-development/
  - 📄 manifest.json 1.1 KB
  - 📄 SKILL.md 978 B
📁 tests/
- 📄 test_all_phases.py 3.0 KB
- 📄 test_check_background_bundles.py 485 B
- 📄 test_check_canonical_terms.py 456 B
- 📄 test_check_community_surfaces.py 675 B
- 📄 test_check_forbidden_paths.py 686 B
- 📄 test_check_golden_artifact_formats.py 2.9 KB
- 📄 test_check_links.py 380 B
- 📄 test_check_loading_budget.py 621 B
- 📄 test_check_nl_routing.py 1.1 KB
- 📄 test_check_question_todos.py 625 B
- 📄 test_check_route_overlaps.py 462 B
- 📄 test_check_routes.py 449 B
- 📄 test_check_semantic_consistency.py 432 B
- 📄 test_check_subagent_registries.py 657 B
- 📄 test_fixture_suite.py 682 B
- 📄 test_generate_index.py 656 B
- 📄 test_validate_assets.py 691 B
📄 .gitignore 354 B
📄 CHANGELOG.md 669 B
📄 CITATION.cff 668 B
📄 CODE_OF_CONDUCT.md 1.3 KB
📄 CONTRIBUTING.md 7.5 KB
📄 LICENSE 1.0 KB
📄 pyproject.toml 1.1 KB
📄 README.md 15.3 KB
📄 README_zh.md 15.2 KB
📄 SECURITY.md 731 B
📄 SKILL.md 21.5 KB
📄 SUPPORT.md 1.4 KB
📄 VERSION 6 B

SKILL.md

---
name: how-to-make-script
description: Root orchestration skill for screenplay creation. Routes requests by intent, medium, stage, output, and constraints, then loads the minimum necessary protocols, rubrics, and knowledge atoms.
---

# How To Make Script

## Purpose
Use this skill when the user asks how to create, diagnose, improve, structure, or adapt a script across narrative, commercial, or interactive media.

This is the root orchestrator. It does not carry all theory inline. It resolves the request into the smallest useful route, then loads only the needed knowledge and sub-skills.

## Preflight Sync

Before routing any request, perform a lightweight sync check against the upstream repository to ensure knowledge assets are current.

**Remote**: `https://github.com/XucroYuri/how-to-make-script` (public)

**Steps**:
1. Query `https://api.github.com/repos/XucroYuri/how-to-make-script/commits/main` to get the latest remote commit SHA.
2. Compare with the local commit SHA (`git rev-parse HEAD` in the repository root). If they match, skip sync.
3. If the remote is ahead, download changed files from `https://raw.githubusercontent.com/XucroYuri/how-to-make-script/main/{relative_path}` and overwrite local copies. Priority sync targets:
   - `SKILL.md` (this file)
   - `references/router-matrix.json`
   - `references/expression-lens-triggers.md`
   - Any protocol, rubric, or knowledge-atom file referenced by the current route
4. After sync, re-read the routing matrix and re-validate the route before proceeding.
5. If the GitHub API or raw content URLs are unreachable, proceed with local assets and note the sync failure in the response.

**Constraints**:
- Do not attempt a full `git pull`; download only the files that have changed.
- Do not block the user's request if sync fails; degradation is acceptable.
- Do not sync on every single request within the same session; cache the last-checked SHA and re-check only if the session has been idle or the user requests a refresh.

## Non-Negotiables
- Route by `intent x medium x stage x output`, then use `constraints` as route signals, tie-breakers, and loading triggers.
- Do not rely on loose keyword matching alone.
- Do not duplicate theory from `knowledge/` into sub-skills.
- Prefer the smallest protocol that can satisfy the request.
- Ask only for missing information that changes the route or output contract.
- Always attach a brief rubric-based self-check to the final result.
- Load reality-lens atoms only when they change routing or output quality.
- Do not collapse to one path when multiple viable options remain during `discover` and `design`.
- Separate hard boundaries from soft constraints before recommending convergence.
- Prefer scope correction over false certainty flips when a rule is challenged but not fully broken.

## Route Selection Heuristics
- Prefer exact medium matches over generic narrative reuse.
- Prefer exact output-contract matches over broad stage matches.
- Prefer diagnostic routing when the user brings existing text and asks what is wrong with it.
- Prefer `quality_gate_report` when the user asks for structured checking, self-audit, preflight, acceptance gating, stage-specific review, targeted recheck, or non-story artifact quality control.
- Prefer one narrow protocol over a broad mixed-context answer.
- Prefer reality-grounded routes when the user asks for audience fit, commissioning fit, or writer growth strategy.
- Prefer `path_options` when the user asks for alternatives, counter-paths, or challenge-driven exploration.
- Prefer `boundary_map` when the user asks what is absolutely disallowed versus flexibly negotiable.
- Prefer `scope_correction` when the user challenges a rule, route, or rubric and the right response is to narrow its scope rather than replace it wholesale.
- Prefer `pattern_reference_pack` when the user asks for strong/weak screenplay examples, success-pattern comparisons, or "why this works better than that" guidance.
- Prefer `context_loading_plan` when the user asks how the skill should load context, balance reference breadth, or avoid context corruption.
- Prefer `story_memory_checkpoint` when the user asks to pause and resume long-form work, compress current story state, preserve continuity across sessions, or hand current state to another human or agent without reloading the whole draft.
- Prefer `voice_style_guide` when the user asks for language-style calibration, character/IP voice continuity, or stronger "alive" expression before drafting.
- Prefer `visual_language_pack` when the user asks for multilingual shot language, cross-language visual vocabulary, or culture-specific film-language calibration.
- Prefer `screen_to_video_brief` when the user asks to bridge screenplay material into a video-generation or previz-ready visual brief.
- Prefer `team_workflow_blueprint` when the user asks for multi-agent collaboration, writers' room design, team workflow design, specialist handoffs, or human-in-the-loop screenplay process design.
- Prefer `expert_subagent_cast` when the user asks which experts, roles, subagents, or reference-persona lenses should participate in a screenplay task.
- Prefer `subagent_dispatch_plan` when the user asks how those subagents should be scheduled, layered, reviewed, or merged.
- Prefer `project_surface_map` when the user asks how a long-running screenplay project should separate source-of-truth assets, runtime state, packet assembly, review surfaces, export surfaces, or phase entrypoints.
- Prefer `research_background_map` when the user asks broad questions such as “how to create a screenplay,” asks for theory support, asks for the repo’s background rationale, or needs a many-angle screenplay research baseline before choosing a narrower route. After that route is selected, use a `survey_pack` only if the breadth is still materially necessary.

## Boundary Rule
Treat constraints in two classes:
- hard boundaries: safety, legal, and non-negotiable constraints that stay active in every phase;
- soft constraints: taste, market, brand, or format preferences that may be relaxed in exploration and reintroduced during review.

When route certainty is low, map boundaries first and then generate path options.

## Reality-Lens Loading Rule
Load audience, industry, history, writer-development, and platform-attention lenses only when one of these is true:
- the requested output is `audience_fit_note`, `development_brief`, or `learning_path`;
- constraints include audience segment, audience need state, commissioning context, business model, release window, platform logic, writer maturity, or reference bar;
- the current draft fails because audience promise and delivery are misaligned.

Keep lens loading bounded: select only the linked atoms required by the chosen protocol.

## Expression-Lens Loading Rule
Load expression-lens assets only when one of these is true:
- the requested output is `voice_style_guide`;
- constraints include `voice_target`, `language_register`, `ip_continuity`, or `experiential_depth`;
- the draft fails because characters sound writerly, samey, fake-premium, NPC-like, or off-model for the target IP;
- adaptation or continuity work cannot proceed safely without a voice anchor first.

When the primary output is still `scene_draft`, `dialogue_polish`, `commercial_script`, or an adaptation artifact, keep the original route and load only the smallest adjunct bundle from [`references/expression-lens-triggers.md`](references/expression-lens-triggers.md).

## Visual-Bridge Loading Rule
Load visual-language or screen-to-video assets only when one of these is true:
- the requested output is `visual_language_pack` or `screen_to_video_brief`;
- constraints include `visual_vocab_locale`, `prompt_runtime`, `shot_granularity`, `reference_asset_mode`, or `continuity_invariants`;
- the user explicitly needs cross-language shot/staging communication, on-screen text strategy, or downstream previz / video-generation handoff;
- a normal screenplay draft cannot proceed safely because downstream visual execution requirements would materially change the next writing decision.

When the primary output is still a screenplay artifact, keep the original route and add only the smallest visual bundle that changes execution quality materially.

## Team-Lens Loading Rule
Load team-collaboration assets only when one of these is true:
- the requested output is `team_workflow_blueprint`;
- constraints include `team_mode`, `coordination_model`, `parallelism_budget`, `human_gate_level`, or `artifact_chain`;
- the task spans multiple deliverables, specialist lanes, or review gates and cannot be modeled well as one undifferentiated writer pass;
- the user explicitly asks for a writers' room, development pod, story trust, brand studio, branch lab, or multi-agent screenplay process.

When the primary output is still a normal screenplay artifact, keep the original route and load team assets only if the collaboration design would materially change role boundaries, review cadence, or handoff safety.

## Subagent-Library Loading Rule
Load subagent-library assets only when one of these is true:
- the requested output is `expert_subagent_cast` or `subagent_dispatch_plan`;
- constraints include `subagent_family`, `persona_policy`, `selection_strategy`, `dispatch_topology`, `convergence_owner`, or `context_budget`;
- the user explicitly asks for named expert roles, real-creator-inspired lenses, process-node design, or multi-level dispatch architecture;
- a normal team blueprint is insufficient because the next decision depends on concrete cast composition or review-order design.

When the primary output is still `team_workflow_blueprint`, keep the original route and load subagent-library assets only if the user needs a concrete cast or a live orchestration plan.

## Project-Surface Loading Rule
Load project-surface assets only when one of these is true:
- the requested output is `project_surface_map`;
- constraints include `project_horizon`, `phase_focus`, `truth_surface_policy`, `runtime_surface_policy`, `packet_strategy`, `traceability_level`, or `edit_policy`;
- the user explicitly asks where humans should edit, where runtime artifacts should live, how packets should be assembled, or how review/export surfaces should be separated;
- a normal screenplay or team-workflow answer would be unsafe because source-of-truth, mirrors, or handoff surfaces are still ambiguous.

When the primary output is still a normal screenplay artifact, keep the original route and load project-surface assets only if surface design would materially change handoff safety, review discipline, or runtime drift risk.

## Continuity-Checkpoint Loading Rule
Load story-memory-checkpoint assets only when one of these is true:
- the requested output is `story_memory_checkpoint`;
- constraints include `phase_focus`, `continuity_invariants`, `traceability_level`, or `context_budget` in a resume or handoff context;
- the user explicitly asks to compress current story state, preserve unresolved lines, or resume later without reloading a large packet;
- broad reloading would otherwise be used only as a continuity crutch rather than because the user truly needs a wider survey.

When the primary output is still a normal screenplay artifact, keep the original route and add a checkpoint only if resumable continuity materially changes the next decision.

## Quality-Gating Loading Rule
Load quality-gating assets only when one of these is true:
- the requested output is `quality_gate_report`;
- constraints include `target_contract`, `audit_scope`, `check_depth`, `lens_focus`, `recheck_mode`, or `acceptance_bar`;
- the user explicitly asks for self-check, stage-specific audit, preflight, acceptance review, lens-targeted review, or recheck after edits;
- the artifact under review is not well served by `rewrite_report` because the real issue is contract fit, delivery readiness, operational feasibility, or cross-artifact quality control.

When the primary output is still a normal screenplay artifact, keep the original route and add the smallest quality-gating bundle only if a preflight or targeted check would materially change the next decision.

## Research-Bundle Loading Rule
Load research-background assets only when one of these is true:
- the requested output is `research_background_map`;
- constraints include `research_scope`, `reference_depth`, or `route_certainty` for an explicitly broad question;
- the user explicitly asks for theory support, background rationale, or a many-angle screenplay-creation research baseline;
- a broad survey would otherwise expand without one declared background anchor.

When the primary output is still a normal screenplay artifact, do not auto-load research bundles just because they exist. Exit the bundle as soon as the user’s next need becomes a narrower route.

## Context Loading Ladder
After route selection, choose one loading mode from [`references/context-loading-modes.md`](references/context-loading-modes.md):
- `route_kernel`: route anchor only.
- `focus_pack`: primary protocol, primary rubric, linked atoms, and one scenario or case anchor when needed.
- `compare_pack`: focus pack plus one rival route or one boundary/contrast layer.
- `teaching_pack`: scenario atlas plus one primary reference pack and one contrastive aid.
- `survey_pack`: only for explicit broad mapping requests; anchor on [`docs/how-to-create-a-screenplay-research.md`](docs/how-to-create-a-screenplay-research.md) and [`docs/source-map-screenplay-creation-research.md`](docs/source-map-screenplay-creation-research.md) before adding narrower craft or medium packs.

Default rule: start narrow, expand one layer at a time, and stop when the next asset would no longer change the answer materially.

## Context Stop Rules
Stop expansion when one of these is true:
- the route is stable and the output contract is fixed;
- the next asset only repeats what is already loaded;
- the answer is drifting toward repo summary instead of task resolution;
- the bundle already contains one route anchor, one execution pack, and one contrastive layer when contrast is needed.

## Routing Steps
1. Classify the request:
   - `intent`: discover, design, draft, polish, diagnose, adapt
   - `medium`: feature_film, episodic, short_drama, animation, commercial, branded_film, shortform_video, game_narrative, branching_interactive
   - `stage`: ideation, premise, character, structure, outline, scene, dialogue, rewrite, adaptation
   - `output`: one of the public contracts in [`references/supported-outputs.md`](references/supported-outputs.md)
    - `constraints`: genre, tone, format, duration, audience segment, audience need state, platform, release window, commissioning context, business model, campaign goal, source medium, draft stage, participation mode, rating, budget, interactivity, franchise/IP limits, writer maturity, research scope, reference bar, creative problem, scenario family, loading mode, reference depth, comparison mode, route certainty, hard boundaries, soft constraints, voice target, language register, aesthetic register, IP continuity, experiential depth, visual vocab locale, prompt runtime, shot granularity, aspect ratio, reference asset mode, continuity invariants, audio mode, text mode, team mode, coordination model, parallelism budget, human gate level, artifact chain, subagent family, persona policy, selection strategy, dispatch topology, convergence owner, context budget, project horizon, phase focus, truth surface policy, runtime surface policy, packet strategy, traceability level, edit policy, target contract, audit scope, check depth, lens focus, recheck mode, acceptance bar
2. Look up the preferred route in [`references/router-matrix.json`](references/router-matrix.json).
   - Use declared `constraint_signals` to explain why the route is appropriate and to break ties between otherwise-equal adjacent routes.
3. Choose the loading mode.
4. Load:
   - one primary workflow protocol;
   - one primary skill wrapper;
   - the linked atoms required by the protocol;
   - the rubric that governs the requested output;
   - only the smallest adjacent references justified by the loading mode.
5. If the request is underspecified, ask only for the minimum missing information that changes the route or output contract.
6. Produce the requested artifact and a compact self-check using the selected rubric.

## Output Pattern
- Return the requested artifact in the requested format.
- Add a brief rubric-based self-check or revision note when useful.
- If the user asks for teaching or explanation, anchor the answer in the relevant protocol and atom references.
- For reference-pattern outputs, use original synthetic fragments and say explicitly that they are reference paths, not the only valid creative route.
- For loading-plan outputs, explain why each expansion step is justified and what should not be loaded yet.
- For voice-style outputs, return anchors, register guardrails, drift warnings, and variability budget rather than a rigid tone template.
- For visual-language outputs, return a task-bounded term set, cultural or hybrid anchors, prompt-ready phrases, and misuse warnings rather than a full dictionary dump.
- For screen-to-video outputs, return source-scene intent, clip mode, main action, camera logic, invariants, avoid rules, and runtime-facing notes without pretending the bridge replaces the screenplay.
- For team-workflow outputs, return mode rationale, roles, handoff packets, review cadence, and human gates rather than vague org-chart prose.
- For expert-cast outputs, return core cast, optional cast, process nodes, persona lenses, authority map, context budgets, and trim order rather than a maximalist wishlist.
- For subagent-dispatch outputs, return control-plane order, topology, phase ladder, packet flow, review loops, human gates, and collapse triggers rather than generic orchestration slogans.
- For project-surface outputs, return canonical sources, runtime surfaces, packet layers, phase entrypoints, sync rules, edit permissions, review surfaces, export surfaces, and drift risks rather than abstract architecture prose.
- For story-memory outputs, return current state, unresolved promises, invariants, dual-track rhythm, and next safe entrypoint rather than a broad story recap.
- For quality-gate outputs, return target contract, scope mode, selected lenses, hard fails, weighted weaknesses, correction ladder, open contradictions, and recheck logic rather than one blended review paragraph.
- For broad screenplay-theory or research-background requests, return the lens decomposition first, then the strongest stable inferences, then the most relevant callable atoms rather than collapsing the answer into one method summary.

## What This Skill Should Prevent
- loading unrelated theory just because it exists in the repo;
- answering a commercial brief as if it were a feature outline;
- flattening interactive branching into ordinary linear plotting;
- giving rewrite advice without identifying the failure layer first;
- giving craft advice detached from audience demand and production context.
- treating one method as a universal truth across mediums, audiences, and eras.
- enforcing soft preferences as if they were hard boundaries during ideation.
- replacing one overbroad rule with its mirror-image overbroad rule after a challenge.
- presenting memorized or quote-like script passages as if they were the repository's own reference patterns.
- expanding context because assets exist, rather than because they change the next decision.
- reloading full drafts, season packets, or room notes when a bounded continuity checkpoint would preserve the needed state.
- flattening all checking into one generic rewrite note, even when the artifact under review is operational, governance-oriented, or contract-heavy.
- running the same fixed audit stack for every medium, artifact family, and delivery surface.
- defaulting every character, IP, or brand to the same neutral authorial language.
- confusing voice guidance with a fixed template that erases scene-specific variation.
- turning multilingual visual language into decorative jargon instead of executable communication.
- flattening screenplay scenes into vendor-specific prompt soup before preserving dramatic function.
- flattening feature, TV room, animation, brand, and interactive workflows into one generic “writer team.”
- treating multi-agent collaboration as full-context sharing instead of bounded handoffs.
- treating real-creator-inspired personas as permission for direct impersonation or exact mimicry.
- stuffing every expert, reviewer, and persona into one cast instead of composing a minimal viable subagent team.
- using one vague multi-agent answer where the task really needs separate mode selection, cast selection, and dispatch design.

## Default Output Contracts
- `logline`
- `premise`
- `synopsis`
- `treatment`
- `beat_sheet`
- `outline`
- `scene_card`
- `scene_draft`
- `screenplay_draft`
- `dialogue_polish`
- `rewrite_report`
- `commercial_script`
- `interactive_branch_map`
- `audience_fit_note`
- `development_brief`
- `learning_path`
- `research_background_map`
- `path_options`
- `boundary_map`
- `scope_correction`
- `pattern_reference_pack`
- `context_loading_plan`
- `story_memory_checkpoint`
- `voice_style_guide`
- `visual_language_pack`
- `screen_to_video_brief`
- `team_workflow_blueprint`
- `expert_subagent_cast`
- `subagent_dispatch_plan`
- `project_surface_map`
- `quality_gate_report`

## Sub-Skills & References

See [`references/skill-directory.md`](references/skill-directory.md) for the complete sub-skill and reference directory.

For runtime route lookup, see the generated execution index (`python scripts/generate_index.py --mode runtime`).

## Operating Principle
Sync first. Resolve the route second. Load the minimum context third. Generate fourth. Self-check last.

Comments 0

Latest | Hot

Please login before commenting.

No comments yet. Be the first one!

how-to-make-script

Directory Structure

SKILL.md

Report

Notice