CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

explain

Explain code, concepts, or system behavior with adjustable depth levels

Quality

74%

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 ./examples/skills/explain/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

67%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.

A well-structured, actionable body with a clear step sequence and concrete commands/templates. Its weaknesses are moderate padding (Purpose, Tips, and verbose depth examples) and a broken Step 4 section that merges into the output format.

Suggestions

Cut the "Purpose" section (it restates the description) and the user-facing "Tips" section, and compress the three depth-level examples to their distinguishing elements — this would materially reduce the ~174-line body.

Fix the structural break at "Step 4: Structure the explanation": give the step real instructions (e.g., "select the output template matching the depth from Step 2") instead of an empty heading followed by a stray `---` and the "## Output format" section.

Add a lightweight verification checkpoint in Step 3, e.g. confirm the target file/symbol exists before explaining (grep returns a match, head succeeds), so the workflow has an explicit validation step.

DimensionReasoningScore

Conciseness

The "Purpose" bullet list restates the description, the "Tips" section addresses the invoking user rather than instructing Claude, and the three full depth-level markdown examples (~40 lines) are padded with generic placeholder text. It is not a 2 because most sections are directly instructional with no conceptual filler Claude already knows; not a 4 because these sections could each be tightened or cut.

3 / 5

Actionability

Concrete, executable guidance throughout: bash context-gathering commands (head/grep/cat), a structured output template with placeholders, and worked examples per depth level. Not a 5 because "Step 4: Structure the explanation" has no body of its own (it collapses into the "## Output format" section after a stray `---`), and the "Related code" entries are unexplained path placeholders; not a 3 because the commands and templates are executable, not pseudocode.

4 / 5

Workflow Clarity

A clear four-step sequence (determine scope → assess complexity → gather context → structure output) with an explicit complexity→depth mapping. Validation checkpoints are absent, but the task is read-only and non-destructive, so the destructive/batch cap does not apply; a cheap verify-the-target-exists step before explaining would still help. Not a 3 because the sequence is coherent with only minor gaps; not a 5 because there is no explicit verification step at all.

4 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are absent), and the single 174-line body is well-sectioned with clear headers and no nested references. Not a 5 because it exceeds the simple-skill threshold (~50 lines) and the depth-level examples and usage examples are candidates for trimming or splitting; not a 3 because the organization is clear and nothing is buried.

4 / 5

Total

15

/

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.

A solid description with a clear what, natural trigger terms, and explicit (if field-separated) when-guidance. Its main weakness is thin action specificity — one verb — and a trigger surface that could collide with adjacent analysis skills.

Suggestions

Fold the when_to_use trigger phrase into the description string itself (e.g., "...with adjustable depth levels. Use when the user asks to explain code, a function, an algorithm, or how a system works") so both are consolidated where they are surfaced.

Add one or two more concrete actions to the description (e.g., "break down control flow and surface design trade-offs") to lift specificity beyond a single verb.

DimensionReasoningScore

Specificity

"Explain code, concepts, or system behavior with adjustable depth levels" names the domain (code, concepts, system behavior) with one concrete action ("explain") plus the depth-level feature — matching the anchor of 1-2 concrete actions without comprehensive coverage. It is not a 2 because it goes beyond minimally naming a domain, and not a 4 because only a single verb is offered where stronger descriptions list several specific actions.

3 / 5

Completeness

The "what" is clearly stated in the description string, and an explicit "when" exists in the frontmatter ("Use when asking Claude to explain code, a function, an algorithm, or a concept"), so the missing-'Use when' cap does not apply. Not a 5 because the trigger clause lives in a separate when_to_use field rather than being consolidated into the description string itself; not a 3 because equivalent explicit trigger guidance is present.

4 / 5

Trigger Term Quality

Natural terms are present — "explain", "code", "concepts", "system behavior" in the description, extended by "a function, an algorithm, or a concept" in the frontmatter's when_to_use — giving good keyword coverage. Not a 5 because common phrasings users actually say ("how does X work", "walk me through", "what does this do") are absent; not a 3 because the covered terms are natural, not jargon.

4 / 5

Distinctiveness Conflict Risk

The explanation-only niche (no editing, reviewing, or building) is mostly distinct from action-oriented skills, with the when_to_use bounding it to explain requests. Not a 5 because "explain code/concepts" is broad enough to overlap with adjacent analysis skills (e.g., code review or documentation skills); not a 3 because the scope is clearly narrower than generic "works with code".

4 / 5

Total

15

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository

FlorianBruniaux/claude-code-ultimate-guide

Path

examples/skills/explain/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.