CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

explain-code

Explains code with visual diagrams and analogies. Use when explaining how code works, teaching about a codebase, or when the user asks "how does this work?", "explain this code", "what does this code do", "walk me through this", "explain this file", "explain this function", "explain this class", "break down this code", or wants to understand code logic, architecture, or behavior. Includes Spring Boot equivalent mappings for non-Java code.

Quality

92%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

88%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-built skill body: highly actionable instructions, a clear sequenced workflow, and appropriate use of a single reference file. The main improvement opportunity is tightening or externalizing the lengthy worked example to improve token efficiency and file structure.

DimensionReasoningScore

Conciseness

The body is efficient with no tutorial filler or explanations of concepts Claude already knows, but the ~55-line inline worked example (full source, Mermaid sequence diagram, six-bullet walkthrough) is a notable chunk that could be trimmed or moved to a reference — fitting "efficient; minor instances of over-explanation that could be trimmed" rather than the lean score-5 anchor.

4 / 5

Actionability

Fully executable guidance: the four required elements, concrete per-target section templates, exact tool names for verification (mcp__claude_ai_Context7__resolve-library-id/query-docs, a gh api command), and a complete worked example demonstrating the expected output end-to-end; nothing is pseudocode or vague.

5 / 5

Workflow Clarity

The explanation process is clearly sequenced (analogy → diagram → walkthrough → gotcha) and the library-verification workflow is a numbered list with explicit decision conditions for when to look things up; this is a read-only explanation task so no destructive/batch validation cap applies.

5 / 5

Progressive Disclosure

Good structure with one clearly signaled, one-level-deep reference (references/spring-boot-mapping.md, which exists) that correctly defers the mapping detail; however, the long inline worked example keeps it at "good structure; minor organization gaps" rather than the cleanly split score-5 anchor.

4 / 5

Total

18

/

20

Passed

Description

96%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 strong description: concrete capabilities, an explicit 'Use when' clause, and an extensive list of natural trigger phrases. The only weakness is slight breadth in the 'teaching about a codebase' trigger that could cause minor overlap with related skills.

DimensionReasoningScore

Specificity

"Explains code with visual diagrams and analogies" plus "Includes Spring Boot equivalent mappings" lists multiple specific concrete actions (explain, diagram, analogy, cross-language mapping) with comprehensive coverage of the skill's capabilities, matching the score-5 anchor; nothing material is missing, so it is above the minor-gaps level of 4.

5 / 5

Completeness

It explicitly answers both what ("Explains code with visual diagrams and analogies") and when ("Use when explaining how code works, teaching about a codebase, or when the user asks...") with concrete trigger phrases, exactly matching the score-5 anchor; a 4 would require the when-clause to be less explicit.

5 / 5

Trigger Term Quality

Quoted natural phrases users would actually say — "how does this work?", "explain this code", "what does this code do", "walk me through this", "explain this file", "break down this code" — alongside broader terms "code logic, architecture, or behavior", giving comprehensive coverage including synonyms; not 4 because no common variation is missing.

5 / 5

Distinctiveness Conflict Risk

The niche (code explanation with diagrams/analogies) is mostly distinct from writing/reviewing skills and the trigger phrases are distinctive, but broad triggers like "teaching about a codebase" and "explain this code" carry minor overlap risk with onboarding or code-review contexts, fitting the score-4 anchor better than 5.

4 / 5

Total

19

/

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

adityamparikh/explain-code-skill

Path

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.