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

81%

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

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 body is a lean, well-structured instruction set with an executable structure-mapping command and a concrete output template; it respects token budget and assumes Claude's competence. Its only weakness is that the endpoint-discovery step ("grep in services") is a hint rather than an executable command or path.

DimensionReasoningScore

Conciseness

The ~35-line body is lean with zero padding and no explanation of concepts Claude already knows; the data-flow diagram and Pinia/Vue Query state split are project-specific knowledge that earns their tokens. This matches anchor 5 — every token earns its place.

5 / 5

Actionability

One fully executable command ("find src/modules/$ARGUMENTS -type f | head -40") plus a concrete output template with defined sections is mostly executable guidance. However, "List the consumed endpoints (grep in services)" is a hint without a command or path, leaving minor gaps that keep it below anchor 5.

4 / 5

Workflow Clarity

The three steps (map structure, summarize in a defined format, output) are clearly sequenced with an unambiguous deliverable, and the read-only task needs no validation checkpoints. The vague "grep in services" mechanics and no guidance for a missing module path leave minor gaps fitting anchor 4 rather than 5.

4 / 5

Progressive Disclosure

The skill is under 50 lines, needs no external references (none exist in the bundle), and is well organized with a Steps section and clearly labeled output subsections. Per the simple-skill guideline, this earns anchor 5 on organization alone.

5 / 5

Total

18

/

20

Passed

Description

70%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, explicit trigger ("Use when onboarding onto a module") and a distinct niche, but the 'what' is implied through the user's need rather than stated as the skill's concrete actions. Adding explicit capability verbs and a few natural synonyms would round it out.

Suggestions

State the 'what' as an explicit action in third person, e.g. "Creates a quick onboarding summary of a module's structure, patterns, endpoints, and key files" rather than framing it only as what the user needs.

Add natural trigger synonyms such as "overview", "understand", or "get familiar with a module" so users phrasing the need differently still match.

List 2-3 concrete capabilities (maps file structure, lists endpoints and state management, flags pattern deviations) to lift specificity from implied to explicit.

DimensionReasoningScore

Specificity

The description names the domain and deliverables ("quick summary of its structure, patterns, and key files") but states no concrete actions the skill performs — no "maps", "lists", or "generates" verbs. This matches anchor 3 (domain plus 1-2 concrete items, not comprehensive) rather than 4, which requires several specific listed actions.

3 / 5

Completeness

An explicit "Use when..." trigger is present, and the 'what' is conveyed through "need a quick summary of its structure, patterns, and key files", though it frames the deliverable as the user's need rather than the skill's action. Both what and when exist with one only implicit, fitting anchor 4 rather than 5's fully explicit dual statement.

4 / 5

Trigger Term Quality

"onboarding", "module", "summary", "structure", and "key files" are terms a user would naturally say when needing this skill, but common variations like "overview", "understand", or "get familiar with" are absent. Good coverage with a few natural terms missing fits anchor 4, not the comprehensive synonym coverage of anchor 5.

4 / 5

Distinctiveness Conflict Risk

"onboarding onto a module" carves a clear niche with distinct triggers, but it could overlap with general code-explanation or documentation skills. Mostly distinct with minor overlap risk matches anchor 4, short of anchor 5's minimal-conflict niche.

4 / 5

Total

15

/

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/vue/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.