CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

docs-onboard

Use when onboarding onto a module and need a quick summary of its structure, patterns, and key files.

Quality

76%

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 ./packs/nuxt/skills/docs-onboard/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

86%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 content is a tight, well-structured instruction skill: executable mapping commands, a concrete summary template, and a clear output criterion with no padding. Its only gaps are implicit commands for the endpoint/component listing steps and the absence of explicit validation checkpoints.

DimensionReasoningScore

Conciseness

The body is lean and directive throughout: executable find commands, one-line section instructions, and parentheticals ('simple shared state', 'server state') that state project conventions rather than concepts Claude already knows. Every token earns its place, matching anchor 5.

5 / 5

Actionability

The find commands are copy-paste ready and the summary template is concrete, but instructions like 'grep in services and server/api/' and 'List components and their responsibilities' leave the exact commands and source directories implicit, fitting anchor 4 rather than 5.

4 / 5

Workflow Clarity

The three steps (map structure, summarize in the given format, output a 2-minute-understandable summary) are clearly sequenced with a final quality criterion, but there are no explicit validation or error-recovery checkpoints beyond that criterion, matching anchor 4.

4 / 5

Progressive Disclosure

The skill is under 50 lines, needs no external reference files (none exist in the bundle), and is well organized with headers and a template, which per the rubric's simple-skill guideline earns anchor 5.

5 / 5

Total

18

/

20

Passed

Description

58%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 has a clear 'Use when...' trigger and a concrete deliverable, but it is thin on specifics and trigger-term coverage. It reads as a single-scenario skill summary rather than a comprehensive, highly distinguishable description.

Suggestions

List the concrete outputs the skill produces (e.g., 'maps file structure, lists endpoints, components, state management, and server routes') to raise specificity.

Add natural trigger variations such as 'get up to speed on', 'understand this module', or 'new to this part of the codebase' so the description matches more user phrasings.

Disambiguate 'module' (e.g., 'codebase module or feature directory') to reduce overlap with package/library documentation skills.

DimensionReasoningScore

Specificity

Names the domain ('onboarding onto a module') and 1-2 concrete actions ('quick summary of its structure, patterns, and key files') but does not list several specific actions or coverage of what the summary includes, so it matches anchor 3 rather than 4.

3 / 5

Completeness

Both 'what' (a quick summary of structure, patterns, and key files) and an explicit 'when' ('Use when onboarding onto a module...') are present, but the trigger guidance covers a single scenario rather than the multiple concrete trigger phrases that anchor 5 requires.

4 / 5

Trigger Term Quality

'onboarding', 'module', and 'quick summary' are natural terms users would say, but common variations and synonyms such as 'get up to speed', 'understand this module', or 'walk me through the codebase' are missing, matching anchor 3.

3 / 5

Distinctiveness Conflict Risk

'Onboarding onto a module' carves out a niche, but 'module' is ambiguous (npm module, framework module, codebase module) and the description could overlap with general code-exploration or summarization skills, fitting anchor 3 better than 4.

3 / 5

Total

13

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

14

/

16

Passed

Repository

fernandezbaptiste/specialist-agent

Path

packs/nuxt/skills/docs-onboard/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.