45ck/content-machine/publish-prep-review

Publish Prep Review

Use When

• The user asks whether a render is ready to post.
• The agent needs a serious readiness gate before human review.
• Claude Code or Codex needs upload metadata plus validation in one

bounded step.

What This Skill Owns

• Final readiness judgment for a short.
• Combining script quality, video validation, and publish metadata in

one review step.

• Failing bad outputs closed instead of pretending they are publishable.
• Pointing the agent back to the right fix path using

`short-form-production-playbook`.

Core Approach

1. Judge the rendered short, not the intent behind it.
2. Treat validation warnings as editorial signals, not just technical

noise.

1. Reject source-text collisions, unreadable cadence, freeze, and weak

pacing even if the MP4 is technically valid.

1. Use the review bundle to decide whether to rework script, audio,

visuals, or captions.

1. When the bundle fails, route the fix through

`short-form-production-playbook` instead of retrying the same bad plan.

Inputs

• final video.mp4
• source script.json
• target platform
• optional validation preferences

Outputs

• validate.json
• score.json
• publish.json
• optional packaging metadata

Output Contract

• Writes validate.json, score.json, and publish.json under the

requested outputDir.

• Optionally writes packaging.json if packaging generation is enabled.
• Validation can include cadence, visual quality, temporal quality,

audio signal, freeze detection, and flow consistency checks in addition to the base format/resolution/duration checks.

• This step reviews the final render. It does not retroactively make

already-captioned source footage acceptable; source-text hygiene belongs in the visuals selection step.

• The goal is a trustworthy go/no-go decision, not paperwork.

Optional Runtime Surface

• Repo-side runner:

node ./node_modules/@45ck/content-machine/agent/run-tool.mjs publish-prep

• Supporting code:

src/harness/publish-prep.ts, src/validate/*, src/score/*

Validation Checklist

• validate.json exists and passed is true.
• score.json exists and passed is true.
• publish.json exists and includes a checklist and description.
• The review outcome clearly tells you what to fix next if it fails.