CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

documentation-criteria

Determines which of PRD, ADR, UI Spec, Design Doc, and Work Plan a change requires, and where each is stored. Use when deciding documentation scope, or when creating or reviewing a technical document.

Quality

84%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

The canonical home for this skill is documentation-criteria in shinpr/claude-code-workflows

SKILL.md
Quality
Evals
Security

Quality

Content

78%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-structured routing skill: lean decision rules, concrete tables and ordered procedures, and exemplary progressive disclosure with all six template references verified present and one level deep. The main gap is that key classification criteria (structural scale, responsibility boundary) rely on abstract phrasing without worked examples to make them fully executable.

DimensionReasoningScore

Conciseness

The body contains no padding about concepts Claude already knows and is dense with actual decision rules ("Each document fixes one class of decision that the repository alone cannot supply"), but several long boundary sentences in "What Each Document Fixes" (e.g., the Design Doc paragraph's release-execution clause) could be tightened. Efficient with minor trimmable instances — anchor 4, not 5.

4 / 5

Actionability

As an instruction-only skill it supplies concrete, usable guidance: the Creation Decision Matrix, a 3-step ordered build procedure, two explicit ADR filters, a storage table with paths and naming conventions. However, classifying terms like "one evident repository-supported implementation", "one coherent outcome", and "responsibility boundary" are left to judgment without worked examples, which keeps it below fully executable (anchor 5).

4 / 5

Workflow Clarity

The build path is clearly sequenced ("1. Select the base path ... 2. Insert an applicable UI Spec ... 3. ... insert an ADR batch") with ordering gates ("Continue after PRD approval") and checkpoints ("check existing ADRs first", "review the complete batch together"). This is a decision-routing skill, not a destructive/batch operation, so no validation cap applies; it sits at anchor 4 because an explicit verification of the scale classification is only implicit.

4 / 5

Progressive Disclosure

The body is a genuine overview that explicitly defers content to its templates ("This file holds the routing decision ... What to write inside one is defined by its template"), and every referenced path (all 6 files in references/) exists and is one level deep, clearly signaled both in the Storage Locations table and the References section. This matches anchor 5: clear overview, well-signaled references, appropriate split.

5 / 5

Total

17

/

20

Passed

Description

83%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: explicit what-and-when structure, third-person voice, concrete document-type triggers, and a well-defined routing niche. The only weaknesses are slightly incomplete trigger synonym coverage and a mildly broad 'technical document' trigger that could collide with general documentation skills.

DimensionReasoningScore

Specificity

The description names the five concrete document types ("PRD, ADR, UI Spec, Design Doc, and Work Plan") and two specific functions ("Determines which ... a change requires, and where each is stored") in third-person voice. Not a 5 because it stops at the routing actions and does not enumerate the broader capability set (e.g., ADR decision filters, scale classification), leaving minor coverage gaps.

4 / 5

Completeness

It explicitly answers both questions: what ("Determines which of PRD, ADR, UI Spec, Design Doc, and Work Plan a change requires, and where each is stored") and when ("Use when deciding documentation scope, or when creating or reviewing a technical document") with concrete trigger phrases. This matches the score-5 anchor; score 4 would require the 'when' to be less explicit, which it is not.

5 / 5

Trigger Term Quality

Natural trigger phrases like "deciding documentation scope", "creating or reviewing a technical document", plus the document-type names users would actually say ("PRD", "ADR", "Design Doc") give good coverage. Not a 5 because common variations such as "spec", "requirements doc", or "write documentation" are absent.

4 / 5

Distinctiveness Conflict Risk

The named document types give it a clear niche with distinct triggers, but the fairly broad trigger "when creating or reviewing a technical document" could overlap with generic document-writing or review skills. Mostly distinct with minor overlap risk, matching the score-4 anchor rather than 5's minimal-conflict standard.

4 / 5

Total

17

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

shinpr/claude-code-workflows

Path

dev-workflows-fullstack/skills/documentation-criteria/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.