CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

codebase-walkthrough

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

Quality

84%

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-crafted, instruction-only skill body: a fully sequenced 8-step walkthrough process with executable recall/retain templates, an explicit validation checklist, and built-in fallbacks. Its only notable weaknesses are repeated diagram-rendering instructions across three sections and minor trims, which slightly dilute token efficiency and organization.

DimensionReasoningScore

Conciseness

The body is efficient and assumes Claude's competence (no basic-concept padding), but the diagram-rendering guidance is repeated in three places (the complexity callout, Step 2's dense paragraph, and Step 7) and includes trimmable asides like the markdown-embed rendering note, fitting anchor 4's 'minor instances of over-explanation'.

4 / 5

Actionability

Guidance is copy-paste executable: concrete templates ('recall("<project>: <topic from ticket>")', 'retain(...)' with tags), an exact command ('devflow visualizations render <path>.excalidraw'), and specific criteria ('the relevant 5-20 lines', 'exact file path and line numbers') covering the common walkthrough cases; per the rubric's scoring note, this instruction-only skill's lack of code is not penalized.

5 / 5

Workflow Clarity

Eight clearly sequenced steps with an explicit pre-presentation Quality Checklist and real feedback loops (unverifiable assumptions must be flagged and checked; ASCII fallback when render-diagram is unavailable; user questions treated as gaps to fill and back-fill proactively), matching anchor 5's explicit validation and error-recovery pattern. No destructive or batch operations, so no cap applies.

5 / 5

Progressive Disclosure

The single-file skill has good structure — clear Steps, Checklist, and Important sections with no nested references — but at ~95 lines it exceeds the under-50-line simple-skill exception, and the diagram guidance that appears in both the callout and Step 2 could be consolidated into one place (minor organization gaps per anchor 4).

4 / 5

Total

18

/

20

Passed

Description

75%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 solid description that clearly states its niche, concrete actions, and timing scope in third person without fluff. Its main limitation is that the 'when' guidance ('before implementation') is terse rather than an explicit 'Use when...' clause with concrete trigger phrases, and it undersells some capabilities the body delivers (identifying what changes, files-to-read lists, assumption verification).

Suggestions

Add an explicit trigger clause, e.g. 'Use when the user is about to implement a feature and wants to understand the affected codebase first — walking through unfamiliar code, onboarding to a new area, or reviewing architecture before building.'

Mention the walkthrough's deliverables in the description (end-to-end flow diagram, affected files, files-to-read list, verified assumptions) to round out coverage beyond 'trace' and 'explain'.

Include natural synonyms users would actually say — 'walk me through the codebase', 'how does this work', 'onboarding' — to strengthen trigger-term coverage.

DimensionReasoningScore

Specificity

The description names the domain ('Deep codebase walkthrough before implementation') and lists several specific actions — 'trace the full flow, explain architecture' — with minor gaps rather than the comprehensive coverage of anchor 5; 'build understanding' is outcome-oriented rather than a concrete action.

4 / 5

Completeness

It answers both 'what' ('trace the full flow, explain architecture, and build understanding') and 'when' ('before implementation'), but the 'when' could be more explicit as a concrete 'Use when...' trigger phrase, matching anchor 4 rather than the fully explicit anchor 5.

4 / 5

Trigger Term Quality

Natural terms users would say are present — 'codebase walkthrough', 'implementation', 'architecture', 'full flow' — giving good coverage, but common variations like 'onboarding', 'explain how the system works', or 'familiarize' are missing, so it falls short of anchor 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

'Deep codebase walkthrough before implementation' carves a mostly distinct pre-implementation-understanding niche with minor overlap risk against generic code-explanation or onboarding skills, fitting anchor 4 rather than the minimal-conflict anchor 5.

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

relative_links

Relative link issues: 1 missing

Warning

Total

15

/

16

Passed

Repository

AndreJorgeLopes/devflow

Path

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.