CtrlK
BlogDocsLog inGet started
Tessl Logo

docus-playground

Sample skill for testing the Docus agent skills discovery feature. Use to verify that /.well-known/skills/ routes work correctly.

60

Quality

70%

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 ./playground/skills/docus-playground/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.

The body is a lean, well-structured verification checklist with concrete executable endpoints and a single real, clearly-signaled reference file. Its main gap is the slight duplication of the description and lack of an explicit expected-response example.

DimensionReasoningScore

Conciseness

The body is short and assumes Claude's competence, listing only the concrete endpoints to check without padding or explaining what discovery means. The intro sentence restates the description somewhat, a minor instance of over-explanation that keeps it at 4 rather than 5.

4 / 5

Actionability

Concrete, executable guidance is given as explicit HTTP endpoints ('GET /.well-known/skills/index.json') that Claude can run directly. A minor gap is the absence of an example curl or expected response shape, so it does not reach fully copy-paste-ready level 5.

4 / 5

Workflow Clarity

The 'Verify Discovery' section sequences three clear checks that read like a verification checklist. There are no destructive or batch operations requiring validation feedback loops, so the destructive-cap does not apply, but no explicit expected-result verification beyond brief 'should' notes keeps it just below 5.

4 / 5

Progressive Disclosure

This is a simple skill under 50 lines with a well-organized body and a single one-level-deep reference (references/example.md) that exists as a real file and is clearly signaled via a markdown link. Per the simple-skill exception and scoring notes, this meets the level 5 anchor.

5 / 5

Total

17

/

20

Passed

Description

62%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 clearly states what the skill does and when to use it with a distinct, narrow niche, scoring reasonably on completeness and distinctiveness. It is limited by single-action specificity and missing natural user trigger phrases.

Suggestions

Add concrete trigger phrases users would naturally say, e.g. 'Use when testing agent skill discovery, .well-known/skills routes, or skill serving endpoints'.

List the specific verification actions (check index.json, fetch SKILL.md, fetch reference files) to broaden specificity beyond a single action.

Expand trigger term coverage with synonyms like 'agent skills', 'skill serving', and 'discovery routes'.

DimensionReasoningScore

Specificity

The description names the domain ('testing the Docus agent skills discovery feature') and one concrete action ('verify that /.well-known/skills/ routes work correctly'), but coverage is a single action rather than multiple specific ones. It does not reach level 4, which requires several specific actions, but is well above the generic level 2.

3 / 5

Completeness

It states what the skill does ('Sample skill for testing the Docus agent skills discovery feature') and when to use it ('Use to verify that /.well-known/skills/ routes work correctly'). Both what and when are present and explicit, though the 'when' trigger could be more specific, matching level 4 rather than the fully concrete level 5.

4 / 5

Trigger Term Quality

The phrase 'skills discovery' and '.well-known/skills/ routes' provide relevant technical keywords, but the description misses natural user phrases (e.g. 'agent skills', 'discovery routes', 'skill discovery') that a user would actually say. It sits at level 3 (some relevant keywords, missing common variations) rather than 4.

3 / 5

Distinctiveness Conflict Risk

The narrow focus on 'Docus agent skills discovery' and '.well-known/skills/ routes' is a distinct niche unlikely to trigger for unrelated skills. Minor overlap risk with other discovery/test skills keeps it just below level 5.

4 / 5

Total

14

/

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
nuxt-content/docus
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.