CtrlK
BlogDocsLog inGet started
Tessl Logo

diataxis

Structure, classify, and write documentation using the Diátaxis framework. Use when writing docs, README files, guides, tutorials, how-to guides, API references, or organizing documentation architecture. Also use when asked to improve documentation, restructure docs, decide what type of doc to write, or classify existing content. Covers tutorials, how-to guides, reference, and explanation.

99

1.10x
Quality

100%

Does it follow best practices?

Impact

97%

1.10x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

100%Weight 40%Scale 1-3

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

A well-structured methodology skill: concise body, concrete actionable guidance, a clearly sequenced workflow with a built-in check, and clean progressive disclosure via real, well-organized reference files. No dimension shows meaningful weakness.

DimensionReasoningScore

Conciseness

The body is lean — terse bullets, a compact axis table, and on-demand "Load references/X.md" pointers — and avoids explaining concepts Claude already knows; it does not fall to level 2 because there is no padded or unnecessary explanation to tighten.

3 / 3

Actionability

For an instruction-only methodology skill the guidance is concrete and specific: per-type principle bullets, a 5-step "How To Apply" process, the two-question compass, a worked example, and a Common Mistakes table with fixes — actionable rather than merely descriptive.

3 / 3

Workflow Clarity

The "How To Apply" section gives a clear 1–5 sequence with an explicit check ("Check for type mixing") followed by a corrective step ("Separate mixed content"), and the Common Mistakes table acts as a review checklist; this is not a destructive/batch operation so the absence of a hard retry loop does not cap it at 2.

3 / 3

Progressive Disclosure

The body is an overview pointing to one-level-deep reference files, all 12 referenced paths (tutorials.md, how-to-guides.md, compass.md, etc.) exist in ./references/, and the closing "Deep Dives" table provides clear navigation — matching the anchor for a clear overview with well-signaled single-level references.

3 / 3

Total

12

/

12

Passed

Description

100%Weight 40%Scale 1-3

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: third-person voice, multiple concrete actions, explicit "Use when" triggers, and a distinct niche that minimizes conflict risk. It clearly answers both what the skill does and when to invoke it.

DimensionReasoningScore

Specificity

Lists multiple concrete actions — "Structure, classify, and write documentation", "organizing documentation architecture", "improve documentation", "restructure docs", "decide what type of doc to write", "classify existing content" — matching the anchor for listing several specific concrete actions rather than naming only a domain.

3 / 3

Completeness

Explicitly answers both what (structure/classify/write docs via Diátaxis) and when with two "Use when..." clauses naming concrete triggers, satisfying the anchor for clearly answering both with explicit triggers.

3 / 3

Trigger Term Quality

Covers natural terms users would say — "docs", "README files", "guides", "tutorials", "how-to guides", "API references", "improve documentation", "restructure docs" — giving broad coverage of common phrasings rather than technical jargon.

3 / 3

Distinctiveness Conflict Risk

The Diátaxis framework is a distinct niche with specific documentation-architecture triggers unlikely to conflict with other skills; it does not fall to level 2 because its triggers are specific rather than broadly overlapping.

3 / 3

Total

12

/

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
joshuadavidthomas/agent-skills
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.