Template for a format-* skill (copy, fill every section; delete nothing)
Directory: ~/.openclaw/workspace/skills/format-<name>/ → symlink into ~/.openclaw/workspace/.claude/skills/.
format-<name>/
├── SKILL.md # ≤250 lines, the 13 sections below
├── references/
│ ├── beat-sheet.md # the skeleton with timing %, per-beat job, line rules, one STRUCTURE example (illustrative, never shipping copy)
│ └── sources.md # davidaistar/Foreplay refs: what the reference ad does beat by beat (paraphrased), what we keep, what we change
├── evals/evals.json # 4-6 cases: prompt → must/must-not checks
└── memory/learnings.jsonl # seeded with the receipts the skill was built from; append after every run
SKILL.md frontmatter
---
name: format-<name>
description: "<what the ad is, in one sentence>. Use when <trigger phrases Fish would say>. Lane: <cartoon-h3 narrator|dialogue|song / ugc-omni / statics>. Inherits knowledge/ad-formats/_FORMAT-CORE.md." # quoted: an unquoted ": " breaks YAML
---
SKILL.md sections (in this order, markdown ## headings like the other workspace skills)
- Read first —
_FORMAT-CORE.md, the format's references, and which brand files. - When to use / when not — Dawn fit, evidence status (proven / signal / untested), what data says.
- The format — what the viewer sees and hears, length range, aspect, style options, 1-2 reference ads.
- Why it sells — the persuasion mechanism; how it maps to recipe A or B; awareness level.
- Beat sheet — table: beat | % of runtime | job | required elements | line rules. Point to references/beat-sheet.md.
- Pack spec — front matter values specific to this format; cast; envs; speakers/voices; the intent grammar for
## Scene visual intents. - First bullet: Step 0 — combo plan (core §0):plan.py --format <this skill>→ paste the combo block (allcombo_*keys incl.combo_ad_prefix) →tags.py checkPASS. - Visual grammar — shot types per beat, framing, product appearance rules, lane-limit workarounds (no lip-sync, wrist rule), style choices.
- Audio — VO/voices/song, pace targets, gaps, music/SFX, end card.
- Production — exact command sequence, which stages are free vs paid, cost estimate per finished ad, time.
- Gates & QA checklist — checkboxes, format-specific on top of core §4.
- Variants & test plan — the one variable per ad set, hook variants, what to read and when.
- Failure modes — known ways this format breaks + the fix.
- Sources — files this skill was built from.