shokunin-review

Review product, technical, experiment, and strategy documents for decision-readiness.

SKILL.md

GitHub

Shokunin Review

Overview

Use this skill to review a document before a human reviewer does.

It checks whether the document is clear, evidence-backed, decision-ready, and actionable.

When to Use

Use for:

  • PRDs
  • RFCs / technical design docs
  • Experiment plans
  • Product strategy docs

Review Process

  1. Parse artifact
  2. Classify document type
  3. Build review split-lens review
  4. Apply quality gates
  5. Calculate readiness score
  6. Generate report
  7. Suggest next actions
  8. Support feedback / correction loop

Core Principles

  • Review-first, not rewrite-first
  • Find problems, do not make them up
  • Penalize unsupported claims
  • Prefer minimal useful improvements
  • Make scoring traceable