CtrlK
BlogDocsLog inGet started
Tessl Logo

code-to-diagram

Analyze codebases and automatically generate architecture diagrams, flowcharts, and org charts. Uses AST parsing to map import dependencies for Python, JS/TS, Go, and Java, outputting Mermaid or SVG files. Triggered when users ask to visualize code architecture, understand dependencies, draw a flowchart, or create a module diagram from source code.

74

Quality

93%

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

93%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 tight, fully executable skill body: copy-paste commands with a complete parameter table, no token waste, and a correct split between the SKILL.md overview and the bundled analysis script. The only weaknesses are minor validation gaps around the optional SVG rendering path.

Suggestions

Add a brief preflight/validation note for the SVG path, e.g., check `mmdc --version` before running with '--format svg' and fall back to '--format mermaid' if missing.

Include one line on verifying output (e.g., confirm the expected .mmd/.svg files exist in the output directory) to close the workflow loop for batched generation.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence — every section (Usage, Parameters, How It Works, Dependencies, Notes) adds information Claude does not already know, with zero padding or explanation of basic concepts. It matches the anchor 'lean and efficient; every token earns its place'; the 4-anchor's 'minor instances of over-explanation' do not apply here.

5 / 5

Actionability

All guidance is copy-paste ready: executable bash invocations for every variant (basic, per-type, output/format, JSON) plus a parameter table documenting every flag with defaults ('--type, -t: architecture, flowchart, org, all (default: all)'). This fully matches the 'fully executable; copy-paste ready commands; specific examples cover the common cases' anchor.

5 / 5

Workflow Clarity

The workflow is unambiguous for a single-command tool — run the script, outputs land in stdout/--output — and 'How It Works' gives a clear 5-step internal sequence (scan, parse, resolve, generate, render). However, minor checkpoints are absent: no preflight check that 'mmdc' is installed before '--format svg' (only a parenthetical requirement) and no guidance on verifying or troubleshooting output, matching 'clear sequence with most checkpoints present; minor validation gaps' rather than the explicit validation/error-recovery loop of a 5.

4 / 5

Progressive Disclosure

Structure matches the actual bundle: SKILL.md stays a concise overview while the 509-line implementation lives in scripts/analyze_codebase.py, which is real and referenced with correct paths in every example — an appropriate one-level split with no buried or nested references. Sections are well-organized with no content that should be split out, fitting the top anchor.

5 / 5

Total

19

/

20

Passed

Description

92%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: third-person voice, concrete and comprehensive on capabilities, mechanism, languages, and output formats, with an explicit 'Triggered when...' clause covering natural user phrasings. The only gap is a handful of missing synonyms for the trigger terms.

Suggestions

Add common trigger synonyms such as 'dependency graph', 'call graph', or 'project structure diagram' to the Triggered-when clause to broaden natural-user-phrase coverage.

Consider mentioning the diagram output for code review or refactoring contexts (e.g., 'map dependencies before a refactor') to catch users who phrase the need indirectly.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — 'Analyze codebases and automatically generate architecture diagrams, flowcharts, and org charts', 'Uses AST parsing to map import dependencies for Python, JS/TS, Go, and Java, outputting Mermaid or SVG files' — with comprehensive coverage of what the skill does, its mechanism, languages, and outputs. It matches the anchor 'lists multiple specific concrete actions; comprehensive coverage'; there is no neighboring anchor it fits better.

5 / 5

Completeness

It explicitly answers both what ('generate architecture diagrams, flowcharts, and org charts... outputting Mermaid or SVG files') and when ('Triggered when users ask to visualize code architecture, understand dependencies, draw a flowchart, or create a module diagram from source code') with concrete trigger phrases. This is a direct match to the score-5 anchor; a 4 would require the 'when' clause to be less explicit, which it is not.

5 / 5

Trigger Term Quality

Trigger phrases are natural and varied — 'visualize code architecture', 'understand dependencies', 'draw a flowchart', 'create a module diagram from source code' — but a few natural synonyms users would say are missing (e.g., 'dependency graph', 'call graph', ' visualize project structure'). This matches 'good keyword coverage; a few natural terms missing' rather than the comprehensive synonym/extension coverage of a 5.

4 / 5

Distinctiveness Conflict Risk

It occupies a clear niche — AST-based code-to-diagram generation for named languages — with distinct triggers ('visualize code architecture', 'module diagram from source code') unlikely to fire for generic diagramming or general code-analysis skills. Conflict risk with closely related visualization skills is minimal, matching the score-5 anchor.

5 / 5

Total

19

/

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
zebbern/claude-code-guide
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.