CtrlK
BlogDocsLog inGet started
Tessl Logo

qodo-codebase-wisdom

Understand how code works, how a change was done before, and which repos are coupled — to answer a question, plan a code change, debug a regression, or scope a fix, using the qodo CLI's managed tools. Use when a task needs to understand a codebase, its history, or how its repos relate — especially for a repo you don't have checked out or work spanning repos — "how does X work", "where is X defined", "who changed X", "explain this service", "plan the change for X", "what would changing X affect", "which repos depend on X", "why did X regress / when did it break", "has this been fixed before", "how did we solve X".

72

Quality

88%

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

81%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 strong, highly actionable body: copy-paste commands, a routing table, a clear multi-phase workflow with explicit validation and error-recovery loops, and a well-signaled one-level-deep reference. Its main weakness is token weight — policy detail on update notices, sandbox diagnostics, and delivery phrasing inflates SKILL.md and could be pushed to references.

Suggestions

Move the skill-update-notice handling, runtime-update recovery detail, and sandbox-auth diagnostic into references/ (like the existing skill-updates.md pattern), keeping only a one-line pointer and the stop-condition rules in SKILL.md.

Trim the Deliver section: keep the answer → context → implication structure and citation rules, but drop the sample sentence patterns and the repeated no-branding/no-emoji enumerations.

Consolidate the repeated provenance/catalog-refresh caveats (stated in Instructions, Preflight, and Configuration) into a single Configuration section.

DimensionReasoningScore

Conciseness

The body assumes Claude's competence (no explaining git, PRs, or libraries) and is dense throughout, but the Deliver section's sample sentence patterns, the sandbox-auth diagnostic, the skill-update-notice handling, and repeated provenance/refresh caveats are explanation that could be tightened or moved out of SKILL.md. This matches the 3 anchor ('mostly efficient but includes some unnecessary explanation or could be tightened') rather than the 4 anchor's 'minor instances of over-explanation'.

3 / 5

Actionability

Quick start gives copy-paste commands (e.g. `qodo read codebase grep --repo owner/repo --pattern "chargeCard" --json`), the routing table names specific tools, an explicit verification command (`qodo read tools <group> --json`) resolves the illustrative-names caveat, and three worked examples show concrete inputs and expected outputs. This matches the 5 anchor: fully executable guidance covering the common cases.

5 / 5

Workflow Clarity

The sequence is explicit — unadorned version probe → preflight (auth, catalog, repo resolution) → route to tool group → narrow-then-fetch → deliver — with explicit validation gates (version minimum, whoami coverage, catalog refresh) and feedback loops ("Empty or `truncated: true` → narrow once and retry", `MT-TOOL-LOOP` → stop and change approach, stop-on-denial rules). All operations are read-only, so the destructive-operation cap does not apply, and the error-recovery loops match the 5 anchor.

5 / 5

Progressive Disclosure

The single bundle file, references/skill-updates.md, exists, is one level deep, and is clearly signaled from the update-notice section; the body's sections are well-organized and navigable. It falls short of the 5 anchor because sizable edge-case policy (update notices, runtime recovery, sandbox diagnostics) is inlined in SKILL.md where the established pattern suggests it belongs in references — matching the 4 anchor's 'most content appropriately placed; minor organization gaps'.

4 / 5

Total

17

/

20

Passed

Description

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

An exemplary description: concrete capabilities, explicit 'Use when' triggers with verbatim user phrasings, and a clearly staked-out niche. The only weakness is that some trigger phrases are broad enough to compete with generic codebase-exploration skills for purely local work.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — "Understand how code works, how a change was done before, and which repos are coupled — to answer a question, plan a code change, debug a regression, or scope a fix" — with comprehensive coverage and consistent third-person voice. It exceeds the 4 anchor ('several specific actions; minor gaps') because coverage of the skill's purpose is complete.

5 / 5

Completeness

Both halves are explicit: the 'what' (understand code, prior changes, and repo coupling "using the qodo CLI's managed tools") and an explicit "Use when a task needs to understand a codebase, its history, or how its repos relate" clause with concrete trigger phrases. Neither half could be more explicit, so it matches the 5 anchor.

5 / 5

Trigger Term Quality

Natural user phrases are enumerated verbatim: "how does X work", "where is X defined", "who changed X", "explain this service", "plan the change for X", "why did X regress / when did it break", "has this been fixed before", "how did we solve X". This is comprehensive coverage including synonyms and question variants, matching the 5 anchor rather than the 4 anchor's 'a few natural terms missing'.

5 / 5

Distinctiveness Conflict Risk

"using the qodo CLI's managed tools" and "especially for a repo you don't have checked out or work spanning repos" carve a clear niche, but broad triggers like "explain this service" and "how does X work" could also fire for generic local codebase-exploration skills — minor overlap risk matching the 4 anchor. It is not 5 (triggers are broader than a tight niche) and not 3 (the tool binding and cross-repo scope distinguish it from similar skills).

4 / 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
qodo-ai/qodo-skills
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.