Skip to content

doncheli/don-cheli-sdd / .agent/skills/doncheli-spec-score

doncheli-spec-score

Verified

Evaluate the quality of a spec and return a structured score with improvement recommendations. Activate when user mentions "spec quality", "score spec", "how good is my spec", "spec review", "validate spec quality".

Don Cheli: Spec Score

Instructions

  1. Accept a spec file path or read the current spec from .dc/specs/
  2. Evaluate the spec across 5 dimensions (0–10 each):
    • Completeness: all scenarios covered, no missing edge cases
    • Clarity: unambiguous language, no "should", "may", "probably"
    • Testability: each scenario has a verifiable, binary outcome
    • Consistency: no contradictions between scenarios or with existing specs
    • Scope control: no out-of-scope behavior mixed in, single responsibility
  3. For each dimension below 7, provide 2–3 specific improvement suggestions with line references
  4. Compute a weighted total score (Completeness 30%, Clarity 25%, Testability 25%, Consistency 10%, Scope 10%)
  5. Assign a grade: A (90-100), B (75-89), C (60-74), D (below 60)
  6. Grade D specs must be improved before implementation — flag as a hard blocker
  7. Optionally save the score card to .dc/spec-scores/<spec-name>-<date>.md

Output Format

## Spec Score — checkout.feature — 2026-03-28

### Scores
| Dimension     | Score | Weight | Weighted |
|--------------|-------|--------|---------|
| Completeness  |   8   |  30%   |   2.4   |
| Clarity       |   6   |  25%   |   1.5   |
| Testability   |   9   |  25%   |   2.25  |
| Consistency   |   7   |  10%   |   0.7   |
| Scope Control |   8   |  10%   |   0.8   |
| **Total**     |       |        | **7.65**|

### Grade: B

### Improvement Suggestions

**Clarity (score: 6)**
- Line 14: "the system should respond quickly" — define SLA (e.g., "within 200ms")
- Line 28: "valid payment method" — list accepted types explicitly

### Verdict
Spec is implementation-ready with minor clarity fixes recommended.
receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementationStars: 322kUpdated Claude CodeCodexVerifiedInstall
requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirementsStars: 322kUpdated Claude CodeCodexVerifiedInstall
using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallbackStars: 322kUpdated Claude CodeCodexVerifiedInstall
verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions alwaysStars: 322kUpdated Claude CodeCodexVerifiedInstall