CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

docs-governance

Route broad documentation-governance requests to existing ECC skills and run an opt-in, read-only audit of mapped documentation roles, links, ADR indexes, and evidence references. Use when a user asks for documentation governance, project-knowledge organization, documentation integrity, or a deterministic docs audit without naming a narrower skill.

Quality

85%

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

78%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 router skill: lean prose, a concrete routing table, an executable audit command with explicit exit-code validation semantics, and correct use of a single one-level-deep reference file for the role contract. The main improvements are merging the redundant activation sections and spelling out post-routing invocation plus audit failure-handling steps.

Suggestions

Merge the overlapping 'When to Activate' and 'When to Use' sections (and the repeated non-goals in 'Boundaries') into one activation section to tighten conciseness.

Add one or two concrete next-step instructions for the routing outcome — e.g., how to invoke the selected capability skill once chosen — to close the actionability gap after 'Select one smallest matching capability'.

Add a short failure-handling step after the audit invocation (e.g., what to inspect or report when exit code is 1) to give the workflow an explicit feedback loop rather than only 'Report failures, warnings, and ownership gaps'.

DimensionReasoningScore

Conciseness

The body is lean with no explanations of concepts Claude already knows, but the 'When to Activate' and 'When to Use' sections duplicate each other ('Do not activate for a narrowly named skill...' vs 'For a direct ADR or regression request, invoke that specialized skill without routing through this one') and the Boundaries section repeats the intro's non-goals. This matches anchor 4 (minor instances that could be trimmed) rather than the every-token-earns-its-place ideal of anchor 5.

4 / 5

Actionability

The intent-to-skill routing table and the concrete command 'python3 <docs-governance-skill>/scripts/audit-docs.py --root <repository> --scope full' with enumerated exit codes (0/1/2) provide mostly executable guidance. Minor gaps — 'Resolve the selected skill directory first' and routing-table targets are given without invocation mechanics — keep it at anchor 4 rather than fully copy-paste-ready anchor 5.

4 / 5

Workflow Clarity

'How It Works' gives a clear 5-step sequence and the audit section defines explicit exit-code checkpoints and warning semantics, satisfying most of anchor 4. It is not anchor 5 because there is no error-recovery loop beyond 'Report failures, warnings, and ownership gaps' and no guidance on what happens after a capability is selected. The destructive/batch cap does not apply since the audit is explicitly read-only.

4 / 5

Progressive Disclosure

The body is a clear overview that pushes role-resolution detail into a single, clearly signaled, one-level-deep reference ([the artifact-role contract](references/artifact-role-contract.md), verified to exist and to contain the role registry) and keeps scripts bundled under scripts/. The routing table and audit semantics that belong inline stay inline, matching anchor 5's clear overview with well-signaled references.

5 / 5

Total

17

/

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: it states both concrete capabilities (routing and a deterministic read-only audit with enumerated targets), gives explicit 'Use when' triggers including natural user phrasings, and draws a clear boundary against the narrower skills it routes to. The only weakness is that trigger coverage omits a few common synonyms and the routed capabilities are only summarized by the generic verb 'route'.

DimensionReasoningScore

Specificity

The description names the domain and concrete actions — 'Route broad documentation-governance requests to existing ECC skills and run an opt-in, read-only audit of mapped documentation roles, links, ADR indexes, and evidence references' — with enumerated audit targets. It falls short of anchor 5 because the specific routed capabilities (ADR recording, regression preservation, loop design) are collapsed into the generic verb 'route'.

4 / 5

Completeness

It explicitly answers 'what' (routing plus a read-only audit of roles, links, ADR indexes, and evidence references) and 'when' ('Use when a user asks for documentation governance, project-knowledge organization, documentation integrity, or a deterministic docs audit without naming a narrower skill') with concrete trigger phrases and a negative boundary, matching anchor 5.

5 / 5

Trigger Term Quality

'documentation governance, project-knowledge organization, documentation integrity, or a deterministic docs audit' are phrases a user would naturally say. A few natural variants are missing (e.g., 'organize project docs', 'documentation structure'), matching anchor 4 rather than the comprehensive synonym coverage of anchor 5.

4 / 5

Distinctiveness Conflict Risk

'Route broad documentation-governance requests' combined with the explicit carve-out 'without naming a narrower skill' establishes a clear router niche and disambiguates it from the narrower skills it routes to, satisfying anchor 5's 'clear niche with distinct triggers; minimal conflict risk'.

5 / 5

Total

18

/

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

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Repository

affaan-m/ECC

Path

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