doncheli/don-cheli-sdd / .agent/skills/doncheli-spec-score
doncheli-spec-score
VerifiedEvaluate 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
- Accept a spec file path or read the current spec from
.dc/specs/ - 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
- For each dimension below 7, provide 2–3 specific improvement suggestions with line references
- Compute a weighted total score (Completeness 30%, Clarity 25%, Testability 25%, Consistency 10%, Scope 10%)
- Assign a grade: A (90-100), B (75-89), C (60-74), D (below 60)
- Grade D specs must be improved before implementation — flag as a hard blocker
- 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.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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 implementation | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| 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 fallback | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| 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 always | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |