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.

This is a tight, well-organized single-purpose skill: an unambiguous map-then-summarize workflow, no padding, and section headings that double as the output template. The only real gaps are minor — the endpoint-grep step lacks a concrete command and the directory assumptions have no fallback. It is a strong example of a lean instructional skill.

DimensionReasoningScore

Conciseness

The body is lean and efficient — terse section headings, one-line bullets, and two short find commands with zero explanation of concepts Claude already knows — matching the anchor-5 example of every token earning its place.

5 / 5

Actionability

The find commands are concrete and copy-paste ready, but "List the consumed endpoints (grep in services)" is a direction rather than an executable command, and the commands assume a fixed directory layout (src/lib/modules/$ARGUMENTS) with no fallback — anchor 4's "minor gaps".

4 / 5

Workflow Clarity

A clear three-step sequence (map structure → summarize by section → output) that is read-only, so no destructive/batch validation cap applies; it stays at 4 rather than 5 because the grep step is underspecified and there is no guidance for edge cases like a module directory that doesn't exist.

4 / 5

Progressive Disclosure

The skill is under 50 lines, single-purpose, needs no external references (none exist in the bundle), and is organized into well-labeled sections — the rubric's simple-skill guideline explicitly scores this as 5.

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 an explicit and concrete "Use when" trigger and several natural keywords, giving it good completeness and reasonable distinctiveness. Its main weakness is specificity — it describes a single generic action ("quick summary") rather than enumerating the concrete deliverables the skill actually produces. Adding the specific outputs (endpoints, components, state, routes, architecture flags) would lift it into the top band.

Suggestions

Lead with concrete actions that mirror what the skill produces, e.g. "Maps a module's file structure and lists its endpoints, components, state management, routes, and architecture deviations" instead of the generic "quick summary".

Add trigger synonyms users naturally say, such as "Use when ramping up on an unfamiliar module, needing a module overview, or getting familiar with a new codebase".

Make "patterns" concrete — name the specific checks (e.g. oversized components, un-migrated Svelte 4 / SvelteKit 1 patterns) so the "what" is explicit rather than implied.

DimensionReasoningScore

Specificity

The description names the domain and outputs ("quick summary of its structure, patterns, and key files") but offers only one action verb — "summary" — whereas anchor 4 requires several distinct concrete actions like "Extracts…, fills…, merges…".

3 / 5

Completeness

Both parts are present: an explicit "Use when onboarding onto a module…" trigger and a "what" ("quick summary of its structure, patterns, and key files"); the "what" is less comprehensive than the anchor-5 example's multiple listed actions, so it fits anchor 4.

4 / 5

Trigger Term Quality

It includes several natural terms a user would say — "onboarding", "module", "summary", "structure", "key files" — matching anchor 4, though common variations like "overview", "understand", or "ramp up" are missing, so it falls short of anchor 5.

4 / 5

Distinctiveness Conflict Risk

"Onboarding onto a module" carves out a mostly distinct niche with minor overlap risk against general codebase-explanation or architecture-review skills, matching anchor 4 rather than anchor 5's clear-niche bar.

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