CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

docs-contribution-router

Ask which docs path a contribution should take. A user-started orchestrator.

Quality

72%

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 ./plugins/documentation/skills/docs-contribution-router/SKILL.md
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: concise, concrete, and with exemplary progressive disclosure that keeps the body lean while deferring step-by-step workflows to real, verified reference files. The main gaps are the absence of a worked routing example and explicit validation of output against the placement map.

DimensionReasoningScore

Conciseness

The body is lean and assumes competence — tables, short key-fact bullets, and a copy-paste output template with no explanations of concepts Claude already knows. Minor trimmable redundancy remains: the Scalekit exclusion is stated twice and the 'Core principle' section restates the opening paragraph.

4 / 5

Actionability

Highly concrete guidance for an instruction-only skill: exact file path patterns per content type, quantified Aside promotion criteria (exceeds 3 sentences, appears on 2+ pages), and a fully specified output format with character limits. Not a 5 because there is no worked example of a completed routing decision and branch-level commands defer entirely to references.

4 / 5

Workflow Clarity

The routing sequence is clear and unambiguous: classify intent via table, follow the branch, load the named reference, then produce the standardized output, with explicit tie-breaking ('handle placement first'). Not a 5 because there are no explicit validation checkpoints on the produced routing decision (e.g., verifying the proposed path against the placement map), though no destructive or batch operations trigger the cap.

4 / 5

Progressive Disclosure

Exemplary structure: the body is a genuine overview, each branch opens with a clearly signaled 'Load references/...' pointer, all six referenced bundle files exist, references are one level deep, and the adaptation section documents a consumer override mechanism for the placement map.

5 / 5

Total

17

/

20

Passed

Description

53%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.

The description identifies a distinct niche and a clear primary action, but it is terse to a fault: it lacks any trigger guidance ('Use when...') and omits the concrete outputs that would make the capability concrete. It sits at the midpoint of the rubric.

Suggestions

Add a 'Use when...' clause with concrete trigger phrases, e.g., 'Use when a contributor says they want to add or update documentation, add a guide, cookbook recipe, or integration page, or asks where a new docs page should go.'

Enumerate the concrete deliverables in the description itself (content type, file path, frontmatter starter, sidebar label suggestion) instead of leaving them only in the body.

Include natural keyword variations users would say ('documentation', 'new page', 'where should I put this') to strengthen trigger-term coverage.

DimensionReasoningScore

Specificity

Names the docs-contribution domain and one concrete action ("Ask which docs path a contribution should take") but the description stops there, omitting the concrete deliverables the body produces (content type, file path, frontmatter starter, sidebar label), so coverage is not comprehensive.

3 / 5

Completeness

The 'what' is stated clearly (asking/routing a docs contribution to a path), but there is no 'Use when...' clause or equivalent explicit trigger guidance anywhere in the description, which the judging guidelines cap at 3.

3 / 5

Trigger Term Quality

"docs path" and "contribution" are on-domain keywords, but common natural phrasings users would actually say ("documentation", "where should this page go", "new guide", "quickstart") are missing, matching the 'some relevant keywords but missing common variations' anchor.

3 / 5

Distinctiveness Conflict Risk

The docs-contribution-routing niche is distinct and "A user-started orchestrator" signals explicit user invocation, but the description does not delineate it from closely related docs skills (e.g., docs-writing-style, referenced only in the body), leaving minor overlap risk.

4 / 5

Total

13

/

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_field

'metadata' should map string keys to string values

Warning

Total

15

/

16

Passed

Repository

saif-shines/devex-kit

Path

plugins/documentation/skills/docs-contribution-router/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.