CtrlK
BlogDocsLog inGet started
Tessl Logo

docs

Decide which family a doc belongs to before drafting — SDK/developer, user/product, or working-group (WG) — since family sets the audience, home, and tone. Use when creating, moving, or restructuring docs, when unsure which directory a doc belongs in, or when a request says "document this" / "write docs for X" without naming the kind. Routes to the specialized skill for each family.

65

Quality

79%

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

Fix and improve this skill with Tessl

tessl review fix ./.agents/skills/docs/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

75%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: an ordered three-question decision tree, explicit boundary rules, concrete directory homes, and clean handoffs to one-level-deep sibling skills. Its weaknesses are modest — duplicated routing pointers across the table/list/bullets, a governing-skill table cell overloaded with links, and an SDK-quality section that stays at principles rather than examples.

Suggestions

Consolidate the routing pointers: docs-wg, docs-canvas, and docs/AGENTS.md each appear in the family table, the numbered routing list, and the boundaries bullets — state each once and cross-reference to cut roughly 15 lines of duplication.

Move the user-docs 'Governing skill' rules out of the table cell into the routing list or a short subsection, so the fallback chain (docs-canvas → seo + docs-svg-kit → AGENTS.md) is scannable instead of buried in a cell.

Add one short concrete exemplar to the SDK section (e.g., a 3-line code-and-prose snippet showing 'every non-trivial API earns a runnable example') so the SDK guidance is demonstrable, not just principled.

DimensionReasoningScore

Conciseness

The body is dense, repo-specific doctrine with essentially no generic filler Claude already knows, and it explicitly defers shared rules ('Read it once; this skill does not repeat it'). However, routing targets (docs-wg, docs-canvas, docs/AGENTS.md) are repeated across the family table, the numbered routing list, and the boundaries bullets, and flourishes like 'The boundaries are real, not bureaucratic' could be trimmed — efficient with minor over-explanation, anchor 4 rather than the every-token-earns-its-place lean of anchor 5.

4 / 5

Actionability

The decision procedure is executable: 'Ask, in order:' with three concrete questions, each mapped to a family, a skill link, and concrete homes ('packages/<pkg>/docs/', 'docs/reference/**'), plus boundary rules like 'Plans live in untracked *.plan.md files'. The SDK section stays at the principle level ('Every non-trivial API earns a short, runnable example') without a concrete exemplar of its own — mostly executable guidance with minor gaps, never dropping to vague-only direction.

4 / 5

Workflow Clarity

The routing workflow is clearly sequenced ('Ask, in order: 1… 2… 3…') with an explicit early exit ('If the request fits one family cleanly, hand off to its governing skill and stop reading here'). No destructive or batch operations are involved, so the validation cap does not apply; the post-routing SDK authoring path has no checkpoints beyond principles, which keeps it at anchor 4 rather than the explicit validation-loop structure of anchor 5.

4 / 5

Progressive Disclosure

The skill is appropriately an overview that defers detail to one-level-deep, clearly signaled references ([docs/AGENTS.md](../../../docs/AGENTS.md), [docs-wg](../docs-wg/SKILL.md), [docs-canvas](../docs-canvas/SKILL.md)); no bundle reference files exist to inline, and nothing nests two levels deep. The user-docs 'Governing skill' table cell crams several links plus fallback rules into one cell and some links repeat in prose — good structure with minor organization gaps, anchor 4 rather than the easy-navigation ideal of anchor 5.

4 / 5

Total

16

/

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 router-skill description: it states what (classify a doc into one of three named families), why (family sets audience, home, and tone), and an explicit multi-condition 'Use when' clause with natural trigger phrases. Third-person imperative voice is consistent throughout.

DimensionReasoningScore

Specificity

The description enumerates the three families ('SDK/developer, user/product, or working-group (WG)') and names two concrete actions — 'Decide which family a doc belongs to before drafting' and 'Routes to the specialized skill for each family' — plus the consequence ('family sets the audience, home, and tone'). It sits above the 1-2-action anchor but below comprehensive, since it doesn't say what this skill itself does for the family it retains.

4 / 5

Completeness

Both halves are explicit: what ('Decide which family a doc belongs to before drafting — SDK/developer, user/product, or working-group (WG)'), and when ('Use when creating, moving, or restructuring docs, when unsure which directory a doc belongs in, or when a request says "document this" / "write docs for X"'). This mirrors the anchor-5 pattern of concrete what-plus-trigger-phrases; anchor 4's 'when could be more explicit' does not fit a when clause listing three explicit trigger conditions.

5 / 5

Trigger Term Quality

'creating, moving, or restructuring docs', 'unsure which directory a doc belongs in', and '"document this" / "write docs for X"' are natural phrases a user would say, with multiple variations covered. Common variants like 'documentation' or 'write a user guide' are missing, so it is a notch below the synonym-complete coverage of anchor 5.

4 / 5

Distinctiveness Conflict Risk

The family-routing framing ('which family a doc belongs to') carves a distinct niche, and the description says it 'Routes to the specialized skill for each family' rather than claiming those skills' work. The broad 'document this' trigger overlaps with the sibling doc skills it dispatches to, leaving minor conflict risk — anchor 4, not the minimal-risk clarity of anchor 5.

4 / 5

Total

17

/

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

relative_links

Relative link issues: 19 suspicious

Warning

Total

15

/

16

Passed

Repository
gridaco/grida
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.