CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

explain

Explains the intent behind source code by finding original session transcripts. Use explain with a function, file, or line of code to understand why it exists.

72

Quality

90%

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

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

An exemplary short-form skill body: exact commands, specific error messages with stop conditions, explicit validation at each step, and disciplined brevity. Structure, actionability, and workflow sequencing all fully meet the top anchors with no wasted tokens.

DimensionReasoningScore

Conciseness

At ~35 lines the body is lean with zero concept explanations Claude already knows; the Response Format rules and exact error strings are operational precision rather than padding. Every token earns its place, matching anchor 5.

5 / 5

Actionability

Fully executable guidance: exact commands ('entire version', 'entire explain --no-pager --commit COMMIT_SHA'), copy-paste-ready user-facing error messages, and concrete agent delegation (Haiku for git blame, Sonnet for the transcript). Nothing is pseudocode or vague, matching anchor 5.

5 / 5

Workflow Clarity

A clear 3-step sequence where every step has an explicit validation checkpoint and error-recovery branch (CLI missing, file not tracked, code uncommitted, no transcript found), with instructions to stop and report. This matches anchor 5's explicit validation and error-recovery pattern; the skill is read-only, so the destructive/batch cap does not apply.

5 / 5

Progressive Disclosure

The skill is under 50 lines, single-purpose, and needs no external references — per the rubric's simple-skill note, well-organized sections suffice. The body is cleanly split into intro, Response Format, and Process with no content that belongs in separate files.

5 / 5

Total

20

/

20

Passed

Description

78%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 well-formed description that explicitly answers both 'what' and 'when' with natural trigger phrases in third-person voice. Its main gaps are modest action coverage (single mechanism, outcome unstated) and a few missing synonyms, which keep specificity and trigger quality in the 3-4 range rather than 5.

Suggestions

Add one concrete outcome-oriented action phrase, e.g. 'reads the original session transcript where the code was written' or 'surfaces the conversation that led to this commit', to lift specificity toward anchor 4.

Include natural trigger synonyms users would say, such as 'why was this code written', 'commit history', or 'git blame', to strengthen trigger term coverage.

Sharpen distinctiveness by naming the transcript source explicitly (e.g. 'by finding the Entire session transcript that created it') so generic 'explain this code' requests are less likely to fire it.

DimensionReasoningScore

Specificity

The description names its domain ('intent behind source code') and 1-2 concrete actions ('Explains the intent... by finding original session transcripts'), but stops there. It does not reach anchor 4's 'several specific actions' — the mechanism is single-purpose and what the skill actually returns (the transcript, a summary) is left unstated.

3 / 5

Completeness

Both questions are explicitly answered: what ('Explains the intent behind source code by finding original session transcripts') and when ('Use explain with a function, file, or line of code to understand why it exists') with concrete trigger phrases. The 'when' clause is explicit with specific triggers, matching anchor 5 rather than anchor 4's 'could be more explicit'.

5 / 5

Trigger Term Quality

Natural phrases users would say are present: 'function', 'file', 'line of code', 'understand why it exists', 'intent', 'source code'. A few natural synonyms ('why was this written', 'commit history', 'git blame') are missing, fitting anchor 4 rather than 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

Session-transcript tracing is a distinct niche with its own tooling (the Entire CLI), but 'explain code / why does this exist' phrasing overlaps with generic code-explanation requests, creating minor overlap risk with closely related skills. Not anchor 5 because a plain 'explain this function' request could plausibly fire it.

4 / 5

Total

16

/

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

SnowingFox/ai-skills

Path

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