explain

Deep explanation of complex code, files, or concepts. Routes to expert agents, uses structural search, generates mermaid diagrams. Triggers on: explain, deep dive, how does X work, architecture, data flow.

2.14x

Quality

73%

Does it follow best practices?

Impact

75%

2.14x

Average score across 3 eval scenarios

Securityby

High

Do not use without reviewing

Fix and improve this skill with Tessl

tessl review fix ./data/skills-md/0xdarkmatter/claude-mods/explain/SKILL.md

Quality

Content

63%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 detailed, actionable skill body with a clear multi-step workflow and concrete commands. Its main weaknesses are verbosity from duplicated structure and a monolithic layout that inlines content better suited to reference files.

Suggestions

Move the large output template (lines 145-225) and mermaid diagram examples into a separate reference file and link to it, reducing the inline footprint.

Remove the ASCII architecture tree or the Execution Steps section to eliminate duplication of the same five-step flow.

Tighten the Notes section, which restates guidance already covered by Depth Modes and Usage Examples.

Dimension	Reasoning	Score
Conciseness	Mostly efficient and task-oriented without explaining basics Claude knows, but the ASCII architecture tree duplicates the Execution Steps and the large mermaid/output templates plus a restated Notes section could be tightened.	3 / 5
Actionability	Provides concrete, executable bash commands (test, ast-grep, rg, fd, tokei) with fallbacks and routing tables; minor gaps where the Task-tool invocation is described rather than given as a runnable example.	4 / 5
Workflow Clarity	A clear five-step sequence (Detect → Gather → Route → Generate → Integrate) with graceful tool-availability checks; the skill is non-destructive so no validation cap applies, though output verification is only implicit.	4 / 5
Progressive Disclosure	Well-organized into clear sections, but the ~325-line file is monolithic with no bundle files; the large output and mermaid templates that could live in separate reference files are inlined.	3 / 5
	Total	14 / 20 Passed

Description

83%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, third-person description that clearly states capabilities and provides explicit trigger guidance. It is comprehensive on completeness and specificity, with only minor room to add synonyms or extension cues.

Dimension	Reasoning	Score
Specificity	Lists several concrete actions — "Routes to expert agents, uses structural search, generates mermaid diagrams" — alongside the deep-explanation domain, with only minor coverage gaps.	4 / 5
Completeness	Explicitly answers both what (deep explanation routing to expert agents with structural search and mermaid diagrams) and when ("Triggers on: ..." with concrete trigger phrases).	5 / 5
Trigger Term Quality	"Triggers on: explain, deep dive, how does X work, architecture, data flow" provides good natural-phrase coverage users would actually say, missing a few synonyms and file-extension cues.	4 / 5
Distinctiveness Conflict Risk	The deep-explanation niche with triggers like "deep dive" and "architecture" is mostly distinct, with minor overlap risk against general code-understanding skills.	4 / 5
	Total	17 / 20 Passed

Validation

93%

Warnings & errors only

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

Criteria	Description	Result
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	15 / 16 Passed

Repository: NeverSight/skills_feed
Path: data/skills-md/0xdarkmatter/claude-mods/explain/SKILL.md
Commit: 2f57aec

Reviewed: about 23 hours ago

Table of Contents

Discovery Implementation Validation

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.