formatting-audits

thkt's avatarfrom thkt

Design document review format definition with 100-point scoring system. Provides quality evaluation criteria, scoring items, and pass/fail logic for SOW/Spec documents. Combined with confidence markers (✓/→/?) to clarify evaluation evidence. Triggers: SOW review, Spec review, document review, design review, ドキュメントレビュー, 設計レビュー, 90 points, scoring, grading, 品質評価, スコアリング, 合否判定.

⭐3stars🔀0forks📁View on GitHub🕐Updated Jan 4, 2026

When & Why to Use This Skill

This Claude skill automates the rigorous auditing of Statement of Work (SOW) and Technical Specification documents using a standardized 100-point scoring system. It evaluates document quality across four critical dimensions—Accuracy, Completeness, Relevance, and Actionability—providing objective pass/fail judgments to ensure project requirements are clear, testable, and free of technical debt.

Use Cases

  • SOW Quality Assurance: Evaluate Statement of Work documents before project kickoff to ensure all acceptance criteria are testable and project goals align with proposed solutions.
  • Technical Spec Auditing: Review software design specifications to identify missing sections, vague requirements, or YAGNI (You Ain't Gonna Need It) violations using evidence-based confidence markers.
  • Standardized Peer Reviews: Implement a consistent 100-point grading scale across engineering teams to provide objective feedback and clear 'Pass/Fail' thresholds for design document approvals.
nameformatting-audits
description>
allowed-tools[Read, Grep, Glob]
agentsow-spec-reviewer
contextfork
user-invocablefalse

SOW/Spec Scoring (100-point)

Scoring

Category Score Focus
Accuracy 0-25 ✓/→/? markers, evidence
Completeness 0-25 All sections, testable AC
Relevance 0-25 Goals ↔ solutions, no YAGNI
Actionability 0-25 Specific steps, feasibility

Deductions

Issue Points
No confidence marker -5
Missing required section -10
AC without test scenario -5
Vague action item -5
YAGNI violation -5
Inconsistent AC-FR map -10

Thresholds

Score Judgment Action
90-100 PASS Proceed to next phase
70-89 CONDITIONAL Re-review after fixes
0-69 FAIL Major revision needed