CtrlK
BlogDocsLog inGet started
Tessl Logo

documentation-structure

Validates documentation structural integrity including heading hierarchy, metadata, file naming, navigation, and cross-references. Use when checking documentation organization or validating toctree structure.

75

Quality

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

Quality

Content

100%

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

The content is a tight, well-structured instruction-only audit with concrete checks, a sequenced workflow, and an explicit verification checkpoint. It assumes Claude's competence and avoids unnecessary explanation.

DimensionReasoningScore

Conciseness

The body is lean and instruction-focused with no explanation of concepts Claude already knows (e.g., what documentation or toctree is); every section earns its place, matching the lean/efficient anchor.

3 / 3

Actionability

Concrete imperatives with specific targets and examples—"Verify files use lowercase with dashes", "Prefer stable reference roles (`:ref:` for reST, `{ref}`/`{numref}` for MyST)", example filenames like `connect-vscode.rst`—give copy-ready, specific guidance for an instruction-only skill.

3 / 3

Workflow Clarity

A clear six-step sequence (File Naming → Metadata → Directory Placement → Navigation → Cross-References → Verification) ends with an explicit validation checkpoint and a defined completion-status statement, satisfying the explicit-validation anchor.

3 / 3

Progressive Disclosure

Well-organized into Scope/Inputs/Actions/Constraints/Output with no nested references; the skill is self-contained with nothing that needs splitting out, so clear organization alone supports the top anchor.

3 / 3

Total

12

/

12

Passed

Description

85%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description is specific, complete with an explicit Use-when trigger, and clearly distinct; written in correct third person. Trigger term coverage is the only weaker spot, leaning on the jargon term "toctree".

Suggestions

Broaden trigger terms beyond "toctree structure" to include natural phrasings users say, e.g. "Use when reviewing documentation organization, checking heading hierarchy, or fixing broken cross-references and toctree entries."

DimensionReasoningScore

Specificity

Lists multiple concrete structural actions—"heading hierarchy, metadata, file naming, navigation, and cross-references"—matching the anchor for several specific concrete actions rather than the partial domain-level anchor.

3 / 3

Completeness

Explicitly answers both what ("Validates documentation structural integrity including...") and when via a clear "Use when..." clause, satisfying the top anchor for both what and when.

3 / 3

Trigger Term Quality

Includes relevant triggers like "documentation organization" and "toctree structure", but "toctree" is somewhat jargon-heavy and the description omits common natural variations users might say (e.g., "docs structure", "broken links").

2 / 3

Distinctiveness Conflict Risk

The documentation-structure-audit niche with toctree/heading-specific triggers is clearly distinguishable from other skills and unlikely to fire for the wrong skill.

3 / 3

Total

11

/

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
canonical/copilot-collections
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.