# Doncheli Spec Score

> 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".

- **Type:** Skill
- **Install:** `agentstack add skill-doncheli-don-cheli-sdd-doncheli-spec-score`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [doncheli](https://agentstack.voostack.com/s/doncheli)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [doncheli](https://github.com/doncheli)
- **Source:** https://github.com/doncheli/don-cheli-sdd/tree/main/.opencode/skills/doncheli-spec-score
- **Website:** https://doncheli.tv

## Install

```sh
agentstack add skill-doncheli-don-cheli-sdd-doncheli-spec-score
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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/-.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.
```

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [doncheli](https://github.com/doncheli)
- **Source:** [doncheli/don-cheli-sdd](https://github.com/doncheli/don-cheli-sdd)
- **License:** Apache-2.0
- **Homepage:** https://doncheli.tv

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-doncheli-don-cheli-sdd-doncheli-spec-score
- Seller: https://agentstack.voostack.com/s/doncheli
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.