Communitygithub.com

Akira-TL/akira-video-skills

Reviews AI-generated reusable assets (characters, scenes, products) or shot generation results, deciding whether to accept, modify prompts, regenerate, or leave for post-production fixes. Use when generation results return to the project and need identity/structure/continuity/action/cinematography/product authenticity checks or result selection.

What is akira-video-skills?

This skill provides structured decision-making for AI-generated video and image assets, enforcing real result inspection over prompt-based assumptions. It defines five possible outcomes: accept, accept with adjustments, post-production fix, regenerate, or rewrite the definition/prompt. It integrates multi-dimensional reviews covering identity, structure, continuity, action, cinematography, product authenticity, and audio. The skill references detailed QA guidelines, candidate selection logic, failure mode classification, and repair decision trees from accompanying markdown files. It supports static review workflows like media probing, uniform sampling, and 2×2 split inspections via built-in scripts, while emphasizing that automated checks never replace full playback or content verification. It is designed for Akira video projects but its principles apply broadly to any AI media generation pipeline requiring rigorous quality control.

Works with~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Akira-TL/akira-video-skills/tree/HEAD/skills/video/video-review

Ask in your favorite AI

Open a new chat with this agent skill pre-loaded.

Documentation

Video Review

This skill handles the judgment of whether a generation result is worth entering the current production pipeline. It does not lower existing production constraints simply because the asset has already been generated, nor does it rewrite upstream facts to preserve an already-generated result.

1. Inspect the Actual Generation Result First

Review must be based on the actual returned images, videos, or audio, not on prompts, filenames, or assumptions about what the model "should have done."

When the current executor can directly view / play media, inspect the complete artifact; when only partial frames, screenshots, or no audio are available, explicitly note which dimensions have not been verified, and do not pass unobserved content.

To quickly read media metadata, SHA-256, uniformly sample to locate problem frames, or split strict 2×2 four-views frame by frame, prioritize using this skill's built-in scripts/media_review.py: probe reads real media properties, sample writes only auxiliary video frames into the current project's .tmp/review/, split-2x2 mechanically cuts a 1:1 image into four quadrants, and cleanup removes the review auxiliary directory. Sampled frames / split grids / manifests can never replace full playback, audio listening, lip-sync, or character / scene content verification; a mechanical 2×2 success does not mean strict four-view semantic approval.

Video review cannot rely on a single best-looking still frame; it must at least cover the beginning, main action process, and end state, and check motion / audio continuity.

2. Fixed Review Basis

First read the official source corresponding to the result:

  • Reusable assets: corresponding long-term prompts, character/scene/product definitions, and necessary upstream facts;
  • Shot generation results: SHOT.md, current prompt, referenced reusable assets, and adjacent shot continuity;
  • Advertising products: simultaneously load product facts and brand constraints from video-advertising; if this capability is missing, cannot claim the product Gate is complete, first return to akira-video to supplement the optional Package.

The one-time generation package is only used to locate the current round's input, not a higher priority source of facts.

For detailed generation result / asset quality reviews, read references/TAKE-QA.md. When multiple image, audio, or video candidates are returned at once, also read references/CANDIDATE-SELECTION.md, first eliminating identity / product / space / storyboard hard errors, then comparing production suitability and aesthetics. When results are clearly failing, first locate the failure type according to references/FAILURE-MODES.md, then select adopt, post-production fix, regenerate, or rewrite upstream using references/REPAIR-DECISIONS.md; before regenerating, clearly identify the one main variable being changed this round.

3. Review Dimensions

Only check the dimensions applicable to the current object:

  • Identity, costume, material, structure, and state stability;
  • Scene space and key positions validity;
  • Action, performance, cinematography, and timing fulfilling the shot's purpose;
  • Continuity In / Out compatibility with adjacent shots;
  • Product, logo, text, and industrial structure matching factual sources;
  • Dialogue, lip-sync, sound, and ambient audio meeting current requirements;
  • Any obvious drift likely to amplify in subsequent shots.

Do not let a single good-looking frame replace full segment video review.

4. Conclusion

Prefer one of the following clear handling methods:

  • Accept: the result can enter the current production;
  • Accept and Adjust Subsequent: non-critical deviations exist, but accept the actual frame, and let the next shot continue from the real visible state;
  • Post-Production Fix: the main body is generated correctly, the issue is more suited to deterministic editing, compositing, subtitles, logos, volume, or other post-processing;
  • Regenerate: the shot/asset definition is correct, but the current generation result failed;
  • Rewrite Definition or Prompt: the failure came from SHOT.md, long-term assets, or the prompt itself, not random execution.

5. Record Accept Decisions

Shot acceptance decisions follow references/TAKE-DECISION.md to keep concise: record the current generation result, actual exit, acceptable deviations, and items still needing post-production fixes; do not create an extra database.

For which generation result to accept for a shot, maintain a brief "current take" field or equivalent clear record in that shot's SHOT.md, and do not copy a final.mp4.

Eliminated generation results may still be kept for comparison; if the project does not need to retain failed outputs long-term, they can be deleted according to user storage policy, but must not delete the only archived generation result prematurely.

Completion Criteria

Every reviewed result has a clear basis and handling direction; accepted results can proceed to the next shot or full post-production; when regenerating, it is also clear what will be changed next time.

Individual skills in this repo

This repo contains 12 individual skills — each has its own dedicated page.

Akira-TL/akira-video-skills

为 Runway 当前视频模型编译和检查生成提示词;当 video-generation 需要使用 Runway(当前主线 Gen-4.5)的 Text to Video 或 Image to Video,并需要 Runway 专用动作、摄影和时序表达时使用。

Akira-TL/akira-video-skills

为 ByteDance / BytePlus Seedance 当前视频模型编译和检查提示词;当 video-generation 需要使用 Seedance 2.5 的参考素材、时间线、同步声音、视频编辑、延长或多镜头能力时使用。

Akira-TL/akira-video-skills

为 Google Veo 视频生成编译和检查提示词;当 video-generation 需要使用 Veo 的 Text to Video、Image to Video、首尾帧、参考元素或同步声音能力时使用,并先核验具体 Google 使用入口与 model 的当前支持范围。

Akira-TL/akira-video-skills

进入并持续推进一个 AI 视频制作项目;读取或建立 VIDEO.md,根据当前视频脚本、复用素材、镜头、生成结果和整片后期状态,按需路由到 canonical 视频专业 Skill,而不是把所有制作规则塞进一个总提示词。

Akira-TL/akira-video-skills

为品牌短片、产品植入剧情、广告或比赛作品建立产品事实与广告边界;当视频需要准确表达某个具体产品的官方功能、参数、结构、使用方式、品牌素材或产品与剧情关系时使用。

Akira-TL/akira-video-skills

设计并维护 AI 视频中跨镜头复用的角色声音、音色参考、对白声音要求与整片声音关系;当同一角色需要跨镜头保持声音一致,或需要规划语音参考、环境声、音效、音乐与画面的职责边界时使用。

Akira-TL/akira-video-skills

设计 AI 视频中的角色与场景视觉方案;当脚本只说明“需要一个什么样的人/场景”,但还没有形成可稳定生成的外形、服装、材质、色彩、空间、光线和视觉识别系统时使用。

Akira-TL/akira-video-skills

组织整片级剪辑、合成、全片声音和最终成片;当多个已采用镜头需要进入 Premiere Pro、After Effects、DaVinci Resolve 等后期工程,或需要整片字幕、Logo、音乐、混音、比例版本和最终导出时使用。

Akira-TL/akira-video-skills

为 AI 图片或视频生成准备可直接使用的提示词与一次性生成包,并在用户把生成结果带回项目后归档;当需要从正式视频脚本、复用素材和 SHOT.md 编译生成内容、选择参考素材、约定返回文件名或清理临时包时使用。

Akira-TL/akira-video-skills

规划、创建、整理和维护多个镜头会重复使用的视频复用素材;当需要人物/场景/道具/产品提示词、参考图、官方素材、身份与状态参考或其他可重复引用内容时使用。

Akira-TL/akira-video-skills

把小说、章节、故事梗概、品牌 brief 或其他上游内容转换成当前视频自己的脚本层;当需要编写或修订 SCRIPT.md、视频人物表演定义、场景定义、对白或镜头总表时使用。

Akira-TL/akira-video-skills

把 SHOTS.md 中的镜头总览展开成可直接制作的单镜头定义;当需要创建或修改 video/shots/<shot-id>/SHOT.md、镜头连续性、摄影、动作、表演、声音或镜头专属生产约束时使用。

Related Skills