review-readiness-cleanup

Inspect review packets and classify structural readiness issues into Markdown and JSON reports.

4|1|Updated Feb 3, 2026
One-click install
npx skills add https://github.com/danielbaustin/agent-design-language --skill review-readiness-cleanup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: review-readiness-cleanup
Source: https://github.com/danielbaustin/agent-design-language/tree/main/adl/tools/skills/review-readiness-cleanup
Command: npx skills add https://github.com/danielbaustin/agent-design-language --skill review-readiness-cleanup

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Inspect review packets, review plans, finding registers, demo or proof registers, and milestone review docs for structural readiness, classifying safe cleanup, blockers, skipped surfaces, and follow-on needs without remediating findings, publishing reports, or approving review readiness.

Core Features & Use Cases

  • Inspect a review root and associated artifacts to surface structural readiness issues.
  • Classify findings into safe_mechanical_cleanup, blocker, skipped, follow_on_needed, and generate Markdown and JSON reports.
  • Support handoffs to appropriate roles without altering findings or approving readiness.

Quick Start

Run the deterministic helper on a local review root to generate artifacts using the required options: scripts/inspect_review_readiness.py --review-root <path> --out <artifact-root> --run-id <run_id>.

Frequently Asked Questions about review-readiness-cleanup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I classify review readiness issues in a review packet without fixing them?

You can classify review readiness issues by inspecting the review packet root to identify structural findings and categorize them into safe_mechanical_cleanup, blocker, skipped, and follow_on_needed classifications without remediating any findings.

What is a review readiness assessment and when do I need one for milestone reviews?

A review readiness assessment identifies structural readiness issues in milestone review materials, producing actionable signals for handoff. You need one when preparing review packets, demo registers, or packet manifests to ensure finding classifications are structured properly.

Can I generate JSON and Markdown readiness reports from a local review root?

Yes, you can generate JSON and Markdown readiness reports by running the deterministic helper script on a local review root, providing the review path, output artifact root, and run ID as required options to produce structured classification artifacts.

Does the review readiness cleanup process approve review readiness or alter findings?

No, the review readiness cleanup process does not approve review readiness, publish reports, or alter findings. It strictly inspects artifacts to classify safe cleanup, blockers, skipped surfaces, and follow-on needs for handoff to appropriate roles.

What limitations exist when classifying blockers and skipped surfaces in finding registers?

The primary limitation is that classifying blockers and skipped surfaces in finding registers is strictly an inspection task; the process does not remediate findings, publish reports, or approve review readiness, meaning manual intervention is required for actual cleanup.