CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

docs

Use when writing, editing, or organizing documentation, when planning what docs a feature needs, and whenever planning or implementing a new feature or change in a repo (docs ship with the code). Also use when tempted to write docs without naming the readers, without picking a tone, or without loading simple-english and i-have-adhd. Triggers on "write docs for X", "document this feature", "add a guide", "update the docs", "reorganize the docs", "plan feature X", "implement X", or /docs.

Quality

86%

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

77%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-engineered writing skill: the two-phase workflow is unambiguous, validation is built into every gate, and the guidance is concrete enough to execute without guesswork. The costs are duplication between prose sections and the red-flags table, and a monolithic ~360-line body whose more specialized material (the tabs spec, including what look like project-specific Tanstack package lines) would be better split into reference files.

Suggestions

Deduplicate: keep the Forbidden section or the red-flags table for each rule (em dashes, neighbor matching, history leak), not both, cutting the body by roughly a third without losing any rule.

Move the package-manager tabs specification (block syntax, mode rules, framework lines) into a references file such as references/package-manager-tabs.md and leave a one-line pointer plus the core rule (never stack npm/pnpm/yarn in one fence) in SKILL.md.

Generalize or remove the Tanstack-specific install lines (@tanstack/ai-*) which look like leftovers from a particular docs site and add tokens irrelevant to most invocations.

DimensionReasoningScore

Conciseness

Mostly rule-dense and efficient, but there is real duplication: the em-dash ban appears in Forbidden, again in the red-flags table, and again in the neighbor-matching section; the neighbor-matching caveat is stated twice; and the 27-row red-flags table restates body rules nearly verbatim. This fits 'mostly efficient but could be tightened' rather than 4, where trimming would be minor, though it never degenerates into padding that would justify 2.

3 / 5

Actionability

For an instruction-only skill the guidance is maximally concrete: an exact docs-folder search order (docs/, documentation/, content/docs/, site/, website/docs/), a complete copy-paste tab component example with exact mode names, bad/good example pairs for openers, lists, and history-leak, and a mechanical pre-done self-check (search added text for the forbidden glyphs, then run the simple-english self-check). Specific examples cover the common cases, matching the top anchor.

5 / 5

Workflow Clarity

The multi-step process is explicitly sequenced: a flow diagram, a gating precondition for Phase 2 ("Do not write page content until you have stated the readers and the tone, and simple-english plus i-have-adhd are loaded"), a Phase 1 validation step ("Check every reader has a path"), an error path ("If either file is missing, stop and tell the user"), and pre-done checks with a fix-and-retry loop for surviving glyph hits. The red-flags table doubles as a checklist, matching the anchor for clear sequence with explicit validation and feedback loops.

5 / 5

Progressive Disclosure

The single SKILL.md runs ~360 lines with no bundle files and no references; it is well-sectioned (so not a 2) but content that plausibly belongs in separate reference files is inlined, notably the detailed package-manager tabs specification and the long red-flags table. This fits 'some structure but could be better organized; content that should be separate is inline' rather than 4, where placement would be mostly appropriate.

3 / 5

Total

16

/

20

Passed

Description

87%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 with maximal trigger coverage and an explicit what/when pairing. Its main weakness is deliberate breadth: claiming every feature plan and implementation creates real conflict risk with general coding skills, and the description omits the skill's distinctive methodology (readers, tone, page splitting).

DimensionReasoningScore

Specificity

Names several concrete actions ("writing, editing, or organizing documentation", "planning what docs a feature needs"), which places it above the 1-2 action anchor. It falls short of 5 because the skill's actual method (naming readers, picking tone, splitting pages) is not conveyed, leaving minor coverage gaps.

4 / 5

Completeness

Both questions are answered explicitly: the what ("writing, editing, or organizing documentation", "planning what docs a feature needs") and the when (multiple "Use when" clauses plus a concrete trigger-phrase list). This matches the anchor requiring both what and when with concrete trigger phrases; a 4 would mean the when could be more explicit, which it cannot.

5 / 5

Trigger Term Quality

An explicit trigger list covers natural user phrasings with variations: "write docs for X", "document this feature", "add a guide", "update the docs", "reorganize the docs", "plan feature X", "implement X", or /docs. Coverage is comprehensive including synonyms and a slash-command form, matching the top anchor; a 4 would require noticeably missing natural terms, and none are apparent.

5 / 5

Distinctiveness Conflict Risk

The docs domain is a clear niche, but the clauses "whenever planning or implementing a new feature or change in a repo" and triggers "plan feature X", "implement X" make it fire on virtually any repo feature work, overlapping with general planning and implementation skills. This fits 'somewhat specific but could still overlap'; it is not 4 because the overlap with non-docs feature work is more than minor, and not 2 because the core identity is unmistakably documentation.

3 / 5

Total

17

/

20

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.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

TanStack/ai

Path

.agents/skills/docs/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.