Shokunin Review

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

vstakhovsky 8dee9d4 842 B Updated

File contents

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

vstakhovsky/shokunin-review/tree/main/skills/shokunin-review commit 8dee9d4ddf

Frequently asked questions

npx skillmds@latest add vstakhovsky/shokunin-review