CtrlK
BlogDocsLog inGet started
Tessl Logo

documentation-criteria

Documentation creation criteria including PRD, ADR, Design Doc, and Work Plan requirements with templates. Use when creating or reviewing technical documents, or determining which documents are required.

60

Quality

70%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./skills/documentation-criteria/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

67%

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

This is a reasonably well-structured description that clearly identifies its domain and includes an explicit 'Use when' clause with multiple trigger scenarios. Its main weaknesses are moderate specificity in describing what actions it performs (beyond 'criteria' and 'templates') and some overlap risk with other documentation-related skills. Expanding the concrete actions and adding more natural keyword variations would strengthen it.

Suggestions

Add more specific concrete actions, e.g., 'Provides templates, enforces formatting standards, validates required sections for PRDs, ADRs, Design Docs, and Work Plans'

Include common synonyms and variations in trigger terms, such as 'product requirements document', 'architecture decision record', 'spec', 'RFC', 'technical specification'

DimensionReasoningScore

Specificity

Names the domain (documentation creation) and lists specific document types (PRD, ADR, Design Doc, Work Plan), but doesn't describe concrete actions beyond 'creation criteria' and 'templates'. It tells what types of documents but not what specific operations are performed on them.

2 / 3

Completeness

Clearly answers both 'what' (documentation creation criteria including PRD, ADR, Design Doc, and Work Plan requirements with templates) and 'when' (Use when creating or reviewing technical documents, or determining which documents are required). The 'Use when' clause is explicit with multiple trigger scenarios.

3 / 3

Trigger Term Quality

Includes useful terms like 'PRD', 'ADR', 'Design Doc', 'Work Plan', 'technical documents', and 'templates', which users might naturally say. However, it misses common variations and synonyms like 'architecture decision record', 'product requirements', 'spec', 'RFC', 'proposal', or 'documentation template'.

2 / 3

Distinctiveness Conflict Risk

The specific document types (PRD, ADR, Design Doc, Work Plan) help distinguish it, but 'technical documents' and 'documentation creation' are broad enough to potentially overlap with other writing or documentation skills. The 'reviewing' trigger could also conflict with code review or general review skills.

2 / 3

Total

9

/

12

Passed

Implementation

72%

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

This is a well-structured documentation governance skill that provides highly actionable guidance through decision matrices, specific conditions, naming conventions, and template references. Its main weakness is the lack of explicit validation checkpoints and feedback loops in the multi-step document creation workflow, and some verbosity in the detailed document definitions that could be trimmed (e.g., scope boundary statements that repeat what's implied by the purpose). The progressive disclosure is excellent with clear template references.

Suggestions

Add explicit validation checkpoints to the Creation Process—e.g., a checklist to verify each document meets its 'Required Structural Elements' before proceeding to the next document in the creation order.

Add a feedback loop for the Approval step: what happens if a document is rejected? Include guidance on revision and re-review cycles.

Trim the repeated 'Scope' paragraphs from each document definition—these largely restate boundaries that are already implied by the purpose and the Decision Matrix, and consume significant tokens.

DimensionReasoningScore

Conciseness

The skill is fairly dense with useful information, but includes some verbose sections that could be tightened—e.g., the detailed 'ADR Creation Conditions' rationale explanations, the extensive Design Doc section with YAML examples, and repeated scope boundary statements for each document type. Some of this is genuinely novel project-specific knowledge, but the document could be ~30% shorter without losing actionability.

2 / 3

Actionability

The skill provides highly concrete, actionable guidance: a clear decision matrix for which documents to create, specific file paths and naming conventions, explicit structural requirements (e.g., required YAML blocks for Change Impact Map), template references, and precise conditions for ADR creation (e.g., '3+ levels', '3+ locations'). This is copy-paste ready for document creation workflows.

3 / 3

Workflow Clarity

The Creation Process section provides a 4-step sequence (Problem Analysis → ADR Option Consideration → Creation → Approval), and the Decision Matrix shows creation order. However, there are no explicit validation checkpoints or feedback loops—e.g., no step to verify a PRD meets all required structural elements before proceeding to Design Doc, no error recovery guidance if approval is rejected. For a multi-document workflow with dependencies, this is a notable gap.

2 / 3

Progressive Disclosure

Excellent progressive disclosure structure: the skill provides a clear overview with a decision matrix up front, then detailed definitions for each document type, and references six separate template files for actual document creation. All references are one level deep and clearly signaled with consistent formatting and paths.

3 / 3

Total

10

/

12

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.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
shinpr/claude-code-workflows
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.