CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

documentation-strategy

Design and run a documentation system for a team or product. Use this skill when planning what to document, choosing a documentation tool, organizing existing docs, fixing stale documentation, designing a maintenance cadence, or scoping technical writing work. Triggers on documentation, docs, tech writing, knowledge base, wiki, runbook, README, internal docs, doc audit, doc maintenance, stale docs, where do we document. Also triggers when the team is repeatedly answering the same questions or when onboarding takes too long.

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

SKILL.md
Quality
Evals
Security

Quality

Content

67%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, genuinely expert strategy skill with a clear 10-step workflow, useful frameworks, and a concrete output spec. Its main weaknesses are token efficiency — the Diátaxis section duplicates both Claude's prior knowledge and the bundled reference file — and the absence of explicit validation checkpoints or a worked example of the final strategy document.

Suggestions

Compress the four-category section to a short table (category → purpose → example) and delegate examples, properties, and templates to references/doc-types-guide.md, removing the duplication.

Trim rhetorical commentary ('The audit is often eye-opening', 'They know', 'The READ-it-ME promise is') to cut tokens without losing instruction.

Add explicit checkpoints to the workflow, e.g. 'Step 1.5: confirm the audit inventory and gap list with the team before picking homes and owners' and 'Step 6.5: confirm owners have accepted their assignments'.

DimensionReasoningScore

Conciseness

The body is mostly efficient — the tier framework, failure patterns, and ADR template are genuine expertise Claude doesn't have — but it includes unnecessary material: the four-category Diátaxis section ('This four-way split is the Diátaxis framework, well-known in tech writing. Memorize it.') restates a framework Claude already knows and duplicates the bundled references/doc-types-guide.md at ~50 lines, and commentary like 'The audit is often eye-opening' and 'Length isn't the goal. The READ-it-ME promise is' adds tokens without adding instruction. Not 4 because the duplication of the reference file is more than a minor trim; not 2 because most sections do earn their place.

3 / 5

Actionability

For an instruction-only skill the guidance is concrete: a 10-step workflow with specific audit questions, a copy-paste-ready ADR template, per-tier cadence and tool-comparison tables, and an 'Output format' section enumerating the deliverable's components. Not 5 because the steps stop at strategy altitude — no worked example of an audit result or a skeleton of the strategy document itself, so the user must synthesize the final artifact's form.

4 / 5

Workflow Clarity

The 10 steps are clearly sequenced (audit → categorize/tier → gaps → dead weight → homes → ownership → cadence → integration → discoverability → measure) and each step has concrete sub-actions. Not 5 because validation checkpoints are implicit rather than explicit — e.g., no 'confirm the audit with the team' or 'verify owners agreed to their assignments' step — though the cap-3 rule for destructive/batch operations does not apply to this strategy skill.

4 / 5

Progressive Disclosure

Good structure: a clearly signaled, one-level-deep reference (references/doc-types-guide.md, verified to exist, linked with a one-line description at the end) and well-organized sections throughout the ~420-line body. Not 5 because the four-category content is inlined in detail AND duplicated in the reference file, so the split between overview and reference is not clean — the body should summarize in a few lines and delegate the detail.

4 / 5

Total

15

/

20

Passed

Description

96%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 that clearly and explicitly states both capability and trigger conditions with an unusually rich set of natural trigger terms, including situational cues like repeated questions and slow onboarding. The only weakness is minor overlap risk with adjacent content-writing skills, which the description leaves to the body to resolve.

Suggestions

Add a brief boundary clause to the description (e.g., 'for the system and strategy, not writing individual documents — use content-and-copy for that') to reduce overlap with adjacent writing skills at trigger time.

DimensionReasoningScore

Specificity

Beyond the headline 'Design and run a documentation system for a team or product', the description enumerates six concrete actions — 'planning what to document, choosing a documentation tool, organizing existing docs, fixing stale documentation, designing a maintenance cadence, or scoping technical writing work' — which comprehensively covers the skill's scope. Not 4 because coverage has no noticeable gaps; each major facet of the skill's work is named.

5 / 5

Completeness

Explicitly answers both what ('Design and run a documentation system for a team or product' plus the enumerated activities) and when ('Use this skill when...' followed by concrete trigger phrases). Not 4 because the 'when' clause is not merely present but itemized with specific triggering scenarios, exactly matching the anchor-5 example pattern.

5 / 5

Trigger Term Quality

Triggers list is comprehensive with natural synonyms users would actually say: 'documentation, docs, tech writing, knowledge base, wiki, runbook, README, internal docs, doc audit, doc maintenance, stale docs, where do we document', plus situational triggers like 'onboarding takes too long'. Not 4 because common variations and even a natural question phrasing ('where do we document') are already present, matching the top anchor's breadth.

5 / 5

Distinctiveness Conflict Risk

The niche (documentation systems, audits, maintenance cadence for a team) is clearly distinct from content-writing skills, and triggers like 'doc audit' and 'stale docs' are unlikely to fire for the wrong skill. Not 5 because broad terms like 'docs', 'documentation', and 'tech writing' carry some overlap risk with adjacent content/writing skills, and the description itself does not state the boundary against writing individual documents (that disambiguation lives in the body's 'When NOT to use' section).

4 / 5

Total

19

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

rampstackco/claude-skills

Path

skills/documentation-strategy/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.