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

78%

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

This is a tight, command-first instruction sheet: executable find commands, unambiguous per-section output directives, a data-flow reference shape, and attention points for review, all within a compact body. The only weaknesses are small — an unspecified grep for endpoints and an unlinked ARCHITECTURE.md mention.

DimensionReasoningScore

Conciseness

The body is lean and instructive throughout — a task line, an argument substitution, executable find commands, terse section directives, and a data-flow one-liner — with zero explanation of concepts Claude already knows, matching the "every token earns its place" anchor.

5 / 5

Actionability

The `find` commands are copy-paste ready and directives like "List pages and their routes (1 line each)" are concrete, but "grep in services" lacks the actual grep command and "the ARCHITECTURE.md pattern" is invoked without a path or link — minor gaps that fit the "mostly executable" anchor rather than the fully copy-paste-ready one at 5.

4 / 5

Workflow Clarity

The three-step sequence (map structure → summarize by section → output a 2-minute-readable summary) is clearly ordered and read-only, so no validation cap applies; it stays at 4 rather than 5 because checkpoints are implicit — there is no instruction for handling a missing module directory or how to verify the endpoint grep found everything.

4 / 5

Progressive Disclosure

The body is under 50 lines, well organized into a single flow with no inlined bulk that belongs in a separate file; no bundle references exist (no references/, scripts/, or assets/ directories), so per the simple-skill guideline well-organized sections alone merit a 5.

5 / 5

Total

18

/

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 has an explicit "Use when" trigger and a stated deliverable, but the capability side is thin: one generic action ("quick summary") with a few facet nouns and no concrete capability verbs or natural trigger synonyms. It is serviceable but sits below the strong examples, which list multiple specific actions.

Suggestions

Replace the generic "quick summary" with the concrete deliverables the skill actually produces, e.g., "Maps module structure, lists endpoints, pages, components, and hydration islands, and flags deviations from ARCHITECTURE.md patterns."

Add natural trigger synonyms users would say, such as "ramp up on a module", "get familiar with", or "codebase walkthrough", alongside "onboarding".

Mention the stack context (Astro project layout: src/modules, pages, components, islands) in the description to reduce overlap with generic code-exploration skills and improve distinctiveness.

DimensionReasoningScore

Specificity

"a quick summary of its structure, patterns, and key files" names the domain and deliverable facets, but the only action offered is a generic "summary" and "patterns" is vague — matching the anchor for 1-2 concrete actions without comprehensive coverage, not the several-specific-actions anchor at 4.

3 / 5

Completeness

Both parts are present: the "what" is "a quick summary of its structure, patterns, and key files" and the "when" is the explicit "Use when onboarding onto a module". It falls short of 5 because the "what" is a single general action rather than concrete capabilities paired with trigger phrases.

4 / 5

Trigger Term Quality

Terms like "onboarding", "module", and "quick summary" are somewhat natural, but the description misses common variations and synonyms a user might say (e.g., "ramp up", "get familiar with", "walkthrough"), matching the "some relevant keywords but missing variations" anchor rather than the good-coverage anchor at 4.

3 / 5

Distinctiveness Conflict Risk

"onboarding onto a module" carves out a fairly specific scenario with minimal conflict risk, though the generic word "module" (no stack context in the description) leaves minor overlap risk with general code-exploration skills, keeping it below the clear-niche anchor at 5.

4 / 5

Total

14

/

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