Skip to content
cccskills
FreePublished on GitHub

build-blueprint

Use when selects_candidates.yaml exists and the user asks to design structure, build an edit blueprint, or create 04_plan/edit_blueprint.yaml.

The English summary is being prepared. Showing the original description.

See how to install

Files included (1)

  • SKILL.md5.4 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

build-blueprint

いつ使うか

  • 「構成を設計して」「ブループリントを作って」と言われたとき。
  • 04_plan/selects_candidates.yaml があり、rough cut 前の設計を固めるとき。

前提条件

  • schemas/edit-blueprint.schema.json と schemas/uncertainty-register.schema.json を守ること。
  • runtime/commands/blueprint.ts の narrative loop に従うこと。 frame → read → draft → evaluate → confirm → promote
  • 入力は creative_brief.yaml, unresolved_blockers.yaml, selects_candidates.yaml, 任意で STYLE.md。
  • 04_plan/edit_blueprint.yaml は authoring intent、05_timeline/timeline.json は compiled canonical truth とする。 caption text/timing/approval は caption review/finalize と FFmpeg/libass speech route が所有し、 Remotion/HyperFrames は登録済み content element だけを描画する。visual treatment patch、platform profile、SFX rights、shared AudioRenderPlan、agent QA、human approval、platform preview は別の契約とする。

やること(ステップ)

  1. brief の autonomy を見て、full か collaborative かを決める。
  2. 04_plan/edit_blueprint.yaml を作る。 必須の核は sequence_goals, beats, pacing, music_policy, dialogue_policy, transition_policy, ending_policy, rejection_rules。
  3. beats[].target_duration_frames と required_roles を明確にし、候補素材との対応が読めるようにする。
  4. 必要なら caption_policy, timeline_order, duration_policy, quality_targets, trim_policy, active_editing_skills も書く。
  5. 04_plan/uncertainty_register.yaml を作る。 各 uncertainty は id, type, question, status, evidence, alternatives, escalation_required を持つ。
  6. collaborative の場合は beat proposal と pacing を readback し、pacing.confirmed_preferences を入れる。
  7. speech-led / interview では promotion 前に first-pass quality audit を行う。
    • 各 dialogue primary は質問テロップなしでも主語または指示対象、比較の両側、原因と結果、結論が範囲内で回収できる
    • 推薦・受講推奨・CTA は単独で置かず、直前または同じ回答に理由、判断問題、具体的な不利益のいずれかを残す
    • dialogue_policy.cut_tail_hold_sec と cut_audio_fade_out_sec は project の timing policy/profile から解決する
    • ending_policy は完全な最終発言後の動く元素材を policy が要求する tail だけ残し、音声と映像をフェードする。静止フレームで終端を延ばさない
    • 字幕は speech caption 1レイヤーとし、質問・章ラベルに発話本文を重複させない audit に失敗した場合は、尺を優先して通さず、完全な fallback の昇格または候補範囲の再選択を行う。
  8. 明示的な短尺SNS delivery profile では retention audit も行う。
    • hook_priority: aggressive または brief がコールドオープンを要求する場合、最強の実在payoff/reactionを profile が定める opening window だけ先出しし、setupへ戻って完全版を configured start window 内に開始する
    • 同じ素材へ意図的に戻る場合は別source rangeを優先し、必要なら allow_revisit にcallback理由を残す
    • beat.id / beat.label は構造用、画面表示文言は beat.viewer_label に視聴者の言葉で書く。HOOK / LEVEL 1 / PAYOFF / ENDING を brief 指定なしに画面へ出さない
    • talking-head / low-motion素材では policy が定める refresh interval ごとの意味的な転換点に、実在リアクション、 登録済みreframe/punch-in、登録済み強調overlayのいずれかを計画する。無意味なzoomやflashで埋めない
    • credibility_first / 高い信用優先では断片的なspoilerを強制せず、根拠を伴う完全な主張をhookにする
    • このauditは短尺SNS以外へ適用しない
  9. brief がBGMを要求する場合だけ、music_policy にレビュー済みライブラリ/BGM Packからの選曲を明記する。 利用可能な候補がなければ uncertainty_register.yaml に blocker を作り、通常BGMを案件内生成して仮置きしない。 短い単純音を明示的に求める場合だけ usage_class: simple_sound を例外として扱う。

出力 artifact

  • 04_plan/edit_blueprint.yaml
  • 04_plan/uncertainty_register.yaml

注意事項

  • uncertainty_register.yaml の status: blocker は planning 上の blocker。compile gate の hard stop は unresolved_blockers.yaml 側で管理される。
  • beat の role は hero, support, transition, texture, dialogue の enum に合わせる。
  • timeline_order を省略した場合は schema default は editorial。chronological にしたいときだけ明示する。
  • speech-led の first-pass quality audit はユーザーレビューの代替ではなく、明白な意味欠落と終端事故を人間へ出す前に自動修復するための必須ゲートとする。

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

MUST USE when source footage or a material folder is provided and material understanding or 03_analysis generation is needed. Trigger not only on explicit analysis requests ('分析して', '素材を見て') but also when the user points at footage and says things like 'この動画で', 'この素材で', or any request that requires understanding the provided media before planning or editing.

The English summary is being prepared. Showing the original description.

mocchalera/video-os-v25Updated Sep 4, 2026

Use when edit_blueprint.yaml and selects_candidates.yaml are ready and the user asks to compile the rough cut, generate timeline.json, or apply a review patch.

The English summary is being prepared. Showing the original description.

mocchalera/video-os-v25Updated Sep 4, 2026

MUST USE when the user asks to crop, reframe, trim, or improve composition of still photos, especially selected event photos, album photos, portraits, speakers, panels, workshops, or group photos. Use after photo selection or correction when the task is composition improvement rather than selecting images.

The English summary is being prepared. Showing the original description.

mocchalera/video-os-v25Updated Sep 4, 2026

MUST USE when starting a new video project, when the user provides footage and asks to edit/create a video, or when 01_intent/creative_brief.yaml does not yet exist. This skill interviews the user to understand their intent before any editing begins. Never skip this step.

The English summary is being prepared. Showing the original description.

mocchalera/video-os-v25Updated Sep 4, 2026

Use after changing prompts, skills, the compiler, or editorial policies — or when the user asks to measure edit quality, run regression evals, check agreement with approved edits, or says '評価して', '一致率を測って', 'eval を回して'. Compares agent output against human-approved golden projects.

The English summary is being prepared. Showing the original description.

mocchalera/video-os-v25Updated Sep 4, 2026

Use when timeline.json exists and the user asks to export the rough cut or an editable handoff packet to Premiere Pro.

The English summary is being prepared. Showing the original description.

mocchalera/video-os-v25Updated Sep 4, 2026

See all skills by mocchalera

Report a problem with this skill