CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

codebase-walkthrough

Deep codebase walkthrough before implementation — trace the full flow, explain architecture, and build understanding.

Quality

73%

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

Fix and improve this skill with Tessl

tessl review fix ./devflow-plugin/skills/codebase-walkthrough/SKILL.md

The canonical home for this skill is codebase-walkthrough in AndreJorgeLopes/devflow

SKILL.md
Quality
Evals
Security

Quality

Content

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

The body provides a well-sequenced, highly actionable walkthrough workflow with concrete command templates, explicit verification loops, and a pre-presentation checklist. Its main weakness is token efficiency: the diagram-rendering instructions and checklist content repeat guidance already stated in the steps.

Suggestions

Consolidate the rendered-diagram instructions, which currently appear in the complexity callout, Step 2, and Step 7, into a single authoritative location.

Trim or merge the Walkthrough Quality Checklist items that restate step guidance verbatim (side effects, domain terms, assumptions), keeping only true validation checks not already covered.

DimensionReasoningScore

Conciseness

The body is dense with actionable guidance and explains nothing Claude already knows, but the rendered-diagram instruction is repeated three times (the complexity callout, Step 2's 'Lead with a rendered diagram', and Step 7's 'Lead with the big-picture diagram'), a fourth echo appears in 'Visual learners need the map before the details', and the Walkthrough Quality Checklist largely re-encodes the step guidance. Mostly efficient but could be noticeably tightened matches anchor 3; anchor 4 requires only minor trimmable instances.

3 / 5

Actionability

Guidance is concrete and executable for an instruction-only skill: copy-ready command templates ('recall("<project>: architecture")', 'retain(...)', 'devflow visualizations render <path>.excalidraw'), specific thresholds ('the relevant 5-20 lines', node-count cutoffs for diagram complexity), and a '~30 minutes to read' target. It stops short of anchor 5 because there is no worked example of a walkthrough leg or final output covering the common case.

4 / 5

Workflow Clarity

Eight clearly sequenced steps with explicit validation: assumptions must be verified against ticket/docs with an 'if you can't verify, check' feedback loop, a pre-presentation quality checklist, an ASCII fallback when render-diagram deps are unavailable, and a user-question gap-analysis loop. This matches anchor 5's clear sequence, explicit validation steps, error-recovery feedback loops, and checklist.

5 / 5

Progressive Disclosure

The single-file structure is well organized with clear section headers (Steps, Checklist, Important), and there are no buried or nested references — the only external pointers are to sibling skills and tools, which is appropriate. At ~90 lines it exceeds the under-50-line simple-skill case that could score 5 on organization alone, and all content is inline, matching anchor 4's good structure with minor organization gaps.

4 / 5

Total

16

/

20

Passed

Description

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

The description establishes a clear niche and includes a couple of concrete actions with some natural keywords, but it lacks an explicit 'Use when...' trigger clause, which caps its completeness and weakens discoverability. It would also benefit from naming the skill's concrete deliverables and common synonyms like 'onboarding'.

Suggestions

Add an explicit trigger clause, e.g. 'Use when onboarding to an unfamiliar codebase or before implementation begins in an area the user hasn't worked in.'

Replace the abstract 'build understanding' with concrete deliverables the walkthrough produces, e.g. 'map the end-to-end flow, identify affected files, and surface verified assumptions'.

Include natural trigger synonyms such as 'onboarding', 'explain how the system works', or 'code tour' to improve keyword coverage.

DimensionReasoningScore

Specificity

The description names the domain ('Deep codebase walkthrough before implementation') and two concrete actions ('trace the full flow', 'explain architecture'), but 'build understanding' is abstract. This matches anchor 3 (domain plus 1-2 concrete actions, not comprehensive) — it is not anchor 4 because coverage is only two actions with one vague one, and not anchor 2 because real actions are listed.

3 / 5

Completeness

The 'what' is clear (trace the full flow, explain architecture), but there is no explicit 'Use when...' clause; 'before implementation' is a timing fragment inside the 'what' statement, so the 'when' is only weakly implied. Per the judging guideline, a missing explicit trigger clause caps completeness at 3 — anchor 4 requires both what and an explicit (if imperfect) when, which is absent.

3 / 5

Trigger Term Quality

It contains several natural trigger terms a user would say — 'codebase walkthrough', 'architecture', 'trace the full flow', 'implementation' — but misses common variations like 'onboarding', 'new to the codebase', or 'how does the system work'. Good coverage with a few natural terms missing matches anchor 4, falling short of anchor 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

'Deep codebase walkthrough before implementation' carves a fairly distinct pre-implementation understanding niche with low conflict risk, though 'explain architecture' and 'trace the full flow' could overlap with general code-explanation or planning/brainstorming skills. Mostly distinct with minor overlap risk matches anchor 4; anchor 5 requires distinct explicit triggers, which the description lacks.

4 / 5

Total

14

/

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

relative_links

Relative link issues: 1 missing

Warning

Total

15

/

16

Passed

Repository

AndreJorgeLopes/devflow

Path

devflow-plugin/skills/codebase-walkthrough/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.