design-intent
Skill4 starsChanged 2 months agoMITView on GitHub
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.
1 other project uses a version of this.
Adopted by
Most recently taken up by
- boman-ng/skillstheir own version, first seen Oct 25, 2026
Other versions1 project uses a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 1
- boman-ng/skills★ 2same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository23 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- analyze-footageSkill
- build-blueprintSkill
- compile-timelineSkill
- crop-photosSkill
- evaluate-editSkill
- export-premiereSkill
- finish-business-shortSkill
- finish-creator-shortSkill
- finish-interviewSkill
- full-pipelineSkill
- import-premiereSkill
- re-editSkill
- render-videoSkill
- review-roughcutSkill
- select-clipsSkill
- select-photosSkill
- setup-environmentSkill
- short-sound-designSkill
- troubleshoot-errorSkill
- vertical-social-compositionSkill
- vertical-social-platform-deliverySkill
The file
Files
design-intent — 意図ヒアリング
いつ使うか(必ず発火する条件)
- ユーザーが素材を渡して「編集して」「動画を作って」「粗編集して」と言ったとき
- 新しいプロジェクトを開始するとき(
01_intent/creative_brief.yamlが存在しない) full-pipelineの Step 2 として呼ばれたとき- 「意図を決めて」「creative brief を作って」と明示的に言われたとき
このスキルを省略してはいけない。 brief なしに triage や blueprint に進むと、エージェントの判断基準がなくなり品質が下がる。
前提条件
schemas/creative-brief.schema.jsonとschemas/unresolved-blockers.schema.jsonを守ること- 可能なら
03_analysis/assets.jsonと03_analysis/segments.jsonを読み、素材理解を反映すること runtime/commands/intent.tsの dialogue flow に沿うこと:- purpose capture → 2. constraint capture → 3. autonomy capture → 4. blocker extraction → 5. readback confirmation
やること(ステップ)
Step 1: 素材を把握する
03_analysis/assets.jsonがあれば読んで、素材の本数・尺・内容を把握するsegments.jsonのpeak_analysisやdisplay_nameがあれば、どんなシーンがあるかを理解する- 素材がまだ分析されていなければ、先に
analyze-footageスキルを実行する
Step 2: ユーザーにヒアリングする(省略不可)
references/interview-questions.md を参照し、以下の Phase に沿って質問する。
Phase 1: 目的と背景(プロデューサー視点)— 必須
- 何のための映像か
- 誰に見せるか
- 見た人にどうなってほしいか
- 期限や制約
Phase 2: 素材の理解(ディレクター視点)— 素材がある場合は必須
- 一番見せたいシーン
- 使いたくない素材(NG カット)
- 時系列は重要か
- BGM のイメージ
Phase 3: トーンと演出(演出家視点)
- 全体の雰囲気
- 感情のカーブ
- テロップの要否
- 避けたい演出
Phase 4: 自律性の確認(コラボレーション設計)— 必須
- エージェントに任せてよい判断
- 必ず確認してほしい判断
Phase 5: マーケティング視点(該当する場合のみ)
- 配信プラットフォーム
- アスペクト比
Phase 6: 複数納品物の分離(複数尺・複数比率の場合は必須)
- 長尺と短尺、横型と縦型で
audio_policy、CTA、字幕量、冒頭 hook を個別に確認する - 「BGMなし」など1本への判断を、別尺・別プラットフォームへ暗黙に継承しない
- runtime、delivery、audio、CTA のいずれかが異なる納品物は、原則として納品物ごとの brief を作る。共通 brief を使う場合も variant ごとの差分を明記する
質問のルール:
- 1回の質問は最大3つまで。質問攻めにしない
- ユーザーの最初の説明で明らかな項目はスキップしてよい
- 曖昧な回答は深掘りする(「いい感じに」→「具体的には?」)
- ユーザーの言葉をそのまま brief に使う
Step 3: creative_brief.yaml を作成する
references/creative-brief-schema-guide.md を参照し、ユーザーの回答をフィールドにマッピングする。
必須フィールド:
project.title,project.strategy,project.runtime_target_secmessage.primaryaudience.primaryemotion_curve,must_have,must_avoidautonomy.mode,autonomy.may_decide,autonomy.must_askresolved_assumptions- 短尺SNSでは
audio_policyを必ず明示する。CTAが目的に含まれる場合は、表示文言と期待アクションをmust_haveに明記する
Step 4: unresolved_blockers.yaml を作成する
- ヒアリングで解決できなかった疑問を blocker として記録
- 各 blocker:
id,question,status,why_it_matters,allowed_temporary_assumption status: blockerは compile gate を止める hard blocker
Step 5: 読み返し確認(省略不可)
- 作成した brief をユーザーに読み返す
- 「この内容で進めてよいですか?」と確認する
- 修正があれば反映する
出力 artifact
01_intent/creative_brief.yaml01_intent/unresolved_blockers.yaml
注意事項
unresolved_blockers.yamlのstatus: blockerは compile gate を止めるallowed_temporary_assumptionはnullか文字列で必ず埋めるcontent_hintは VLM の認識精度に直結するので、ユーザーの説明から必ず抽出する- profile (
keepsake,commercial等) からduration_modeが自動推定される - brief を埋める前にユーザーに聞く。推測で埋めない。
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

