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.

1.10x

Quality

100%

Does it follow best practices?

Impact

97%

1.10x

Average score across 3 eval scenarios

Securityby

Passed

No known issues

Evaluation results

93%

14%

Getting Started with SnapStore

Tutorial voice, goal-first, concrete steps

Criteria

Without context

With context

First-person plural voice

30%

Goal statement at start

80%

100%

Visible result per step

50%

100%

Narrative expectation phrases

90%

100%

Concrete single path

100%

Minimal explanation

80%

100%

No embedded reference material

100%

No type mixing (explanation)

100%

No 'you will learn' phrasing

90%

100%

Closing accomplishment statement

100%

13%

Practical Guides for the FlowLimit Library

How-to guides: conditional imperatives, assumes competence

Criteria

Without context

With context

'How to' titles

60%

100%

Conditional imperatives

100%

Assumes competence

90%

100%

Concise and on-target

100%

Allows alternatives

100%

No embedded concept explanations

80%

100%

No tutorial content

100%

Links out for depth

40%

100%

Practical completeness

100%

Two or more guides produced

100%

API Reference and Analytics Model Documentation

Reference and explanation type separation

Criteria

Without context

With context

Reference: neutral tone

100%

Reference: consistent patterns

100%

Reference: mirrors API structure

100%

Reference: includes examples

100%

Reference: no how-to content

100%

Explanation: 'About' framing in title

100%

Explanation: design context

100%

Explanation: makes connections

100%

Explanation: admits opinion or perspective

100%

Explanation: no step-by-step instructions

100%

Type separation maintained

100%

Repository: joshuadavidthomas/agent-skills
Commit: 40067f1

Evaluated: 2 days ago
Agent: Claude Code
Model: Claude Sonnet 4.6

Table of Contents

Getting Started with SnapStore Practical Guides for the FlowLimit Library API Reference and Analytics Model Documentation

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.