| Step | Skill | Result |
|---|---|---|
| 1 | /vidcraft:new-project |
Project structure |
| 1b | /vidcraft:doc-analyzer (optional) |
Analysis of existing documentation |
| 1c | /vidcraft:project-conceptualizer |
Concept and episode plan |
| 1d | /vidcraft:brief-creator |
Creative brief |
| 2 | /vidcraft:script-writer |
Script per episode |
| 3 | /vidcraft:script-reviewer |
Check against the checklist |
| 4 | /vidcraft:storyboard-creator |
Visual direction per scene |
| 5 | /vidcraft:screenshot-planner |
List of required screenshots and recordings |
| 5b | /vidcraft:asset-collector |
Comparison with available files |
| 5c | /vidcraft:shot-list-creator |
Shot list |
| 6 | /vidcraft:avatar-selector |
Avatar and voice choice |
| 6b | /vidcraft:pre-generation-check |
Quality gates |
| 7 | /vidcraft:heygen-engineer or /vidcraft:synthesia-engineer |
Platform format |
| 8 | manual | Generation in HeyGen or Synthesia |
| 9 | manual | Post-production, for example intro, outro and cuts in a video editor |
| 10 | /vidcraft:video-reviewer |
Review of the generated video |
| 11 | /vidcraft:subtitle-generator |
Subtitles (DE and EN) |
| 12 | /vidcraft:thumbnail-director, /vidcraft:promo-writer |
Thumbnail concept, promo copy |
| 13 | /vidcraft:release-director |
Release checklist and metadata |
/vidcraft:next-step, /vidcraft:resume and /vidcraft:project-dashboard help along the way. Check skills such as voice-checker, timing-validator, brand-checker and accessibility-checker can be run at any time.
Status lives in the frontmatter of the respective file and is set by the skills. You can also change it deliberately with update_field.
Project:
Concept → Brief Complete → Research Done → Script Draft → Script Approved
→ Storyboard Done → Assets Ready → Generated → Reviewed → Published
Episode:
Not Started → Script Draft → Script Reviewed → Storyboard
→ Assets Collected → Ready for Generation → Generated → QA Passed → Final
Scene:
Outline → Script Written → Visual Defined → Assets Ready → Generated → Approved
The server normalizes status values when it builds the state cache. Short forms are mapped to project statuses:
StoryboardbecomesStoryboard Done,DraftbecomesScript Draft,ApprovedbecomesScript Approved,BriefbecomesBrief CompleteandResearchbecomesResearch Done. This applies on all levels: an episode statusStoryboardor a scene statusApprovedtherefore appears in the query tools asStoryboard DoneorScript Approvedrespectively. The file itself is left unchanged. Unknown values are passed through as they are.
The mapping lives in knowledge/status-workflow.md and is read by resume (project level) and next-step (episode level).
| Project status | Next skill |
|---|---|
| Concept | project-conceptualizer |
| Brief Complete | researcher (optional), otherwise script-writer |
| Research Done | script-writer |
| Script Draft | script-reviewer |
| Script Approved | storyboard-creator |
| Storyboard Done | screenshot-planner, then asset-collector, shot-list-creator |
| Assets Ready | pre-generation-check |
| Generated | video-reviewer |
| Reviewed | release-director |
| Published | Series complete |
| Episode status | Next skill |
|---|---|
| Not Started | script-writer |
| Script Draft | script-reviewer |
| Script Reviewed | storyboard-creator |
| Storyboard | screenshot-planner |
| Assets Collected | pre-generation-check |
| Ready for Generation | heygen-engineer or synthesia-engineer |
| Generated | video-reviewer |
| QA Passed | release-director |
| Final | done |
With several episodes, next-step prefers scripts in status Script Draft first (they block the following steps), then episodes not yet started, then storyboards, assets and the pre-generation check.
The pre-generation check is mandatory before generation: if an episode is still
Not StartedorScript Draft, the gate reportsBLOCKED. See Quality system.
With create_video_idea (for example via doc-analyzer or researcher), ideas are stored as sections in {content_root}/IDEAS.md. /vidcraft:session-start lists them.