CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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 Qodo managed tools through MCP or the CLI. 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".

Quality

82%

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

67%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 is a genuinely actionable, well-structured investigation workflow — concrete commands, a task-routing table, worked examples, and explicit stop/error conditions — held back mainly by repetition: the version gate, read-only guardrails, and auth policy are each restated across multiple sections, and conditional edge-case policy is inlined instead of moved to the existing references.

Suggestions

Consolidate the version-probe guidance, which currently appears in 'Runtime compatibility gate', 'Quick start', and 'Configuration', into a single authoritative section and reference it from the others.

Merge the read-only/guardrail statements repeated across 'Description', 'Choose the execution path', 'Error Handling', and 'Guardrails' into the single Guardrails section.

Move conditional policy blocks (the QODO_NOTICE update-notice handling and the sandbox auth diagnostic) into the existing references/ files (e.g., skill-updates.md), keeping only a one-line pointer in SKILL.md.

DimensionReasoningScore

Conciseness

There is no explanation of concepts Claude already knows, but the ~230-line body repeats the same policies multiple times: the version probe appears in 'Runtime compatibility gate', 'Quick start', and 'Configuration'; read-only/guardrail restatements appear in 'Description', 'Choose the execution path', 'Guardrails', and 'Error Handling'; and edge-case policy (QODO_NOTICE handling, sandbox auth diagnostics, update-origin rules) is inlined rather than deferred. This is 'mostly efficient but could be tightened' — anchor 3 — rather than anchor 4's 'minor instances' of over-explanation.

3 / 5

Actionability

The Quick start gives concrete executable commands (`qodo read codebase grep --repo owner/repo --pattern "chargeCard" --json`), the routing table maps task types to tool groups, and the Examples show full command chains with expected cited outputs. It falls short of anchor 5's copy-paste-ready coverage because the skill itself cautions 'the tool names below are illustrative, not guaranteed current' and requires a catalog-verification call before use — minor but real gaps in executability.

4 / 5

Workflow Clarity

A clear, ordered sequence exists (path selection → version gate → preflight auth/catalog/repo resolution → route to tool group → narrow, then fetch → deliver) with explicit validation checkpoints (version probe, whoami, `isError`/`truncated` checks) and feedback loops (refresh once and retry; 'Empty or `truncated: true` → narrow once and retry'). It stops short of anchor 5 because the workflow must be assembled from several overlapping sections rather than one coherent checklist, and some checkpoints are implicit (e.g., when to re-check versus reuse a prior whoami).

4 / 5

Progressive Disclosure

Three real, one-level-deep, clearly signaled references ([manual-update procedure](references/skill-updates.md), [shell guidance](references/windows-shells.md), [launcher recovery](references/windows-launcher.md) — all verified to exist), and the core workflow is appropriately inline. Anchor 5 is not met because a fair amount of conditional policy (update notices, sandbox auth diagnostics, Windows/launcher handling partially) stays inline in the SKILL.md rather than being split out, leaving the overview heavier than a lean pointer structure.

4 / 5

Total

15

/

20

Passed

Description

91%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, explicit what-and-when structure, and an unusually thorough set of quoted natural trigger phrases. The only weakness is that the most generic triggers ('how does X work', 'where is X defined') overlap with general code-exploration skills rather than uniquely signaling the Qodo/cross-repo niche.

DimensionReasoningScore

Specificity

Lists several concrete capability actions — 'answer a question, plan a code change, debug a regression, or scope a fix' plus 'how a change was done before, and which repos are coupled' — with minor gaps: the underlying tool actions (search, grep, blame, PR history, cross-repo relations) are implied rather than named, and 'Understand how code works' leans slightly abstract. It sits between anchor 3 (1-2 concrete actions) and anchor 5 (comprehensive multi-action coverage), noticeably above the midpoint, so 4.

4 / 5

Completeness

Explicitly answers both: the 'what' ('Understand how code works, how a change was done before, and which repos are coupled ... using Qodo managed tools through MCP or the CLI') and the 'when' ('Use when a task needs to understand a codebase, its history, or how its repos relate'), with concrete trigger phrases and scoping cues ('especially for a repo you don't have checked out or work spanning repos'). Matches anchor 5 exactly; anchor 4's weaker 'when' does not apply since triggers are explicit and enumerated.

5 / 5

Trigger Term Quality

Comprehensive natural-phrase coverage with ten quoted user phrasings — "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" — exactly the synonyms-and-variations coverage anchor 5 requires, not merely the 'good coverage, a few missing' of anchor 4.

5 / 5

Distinctiveness Conflict Risk

A clear niche — Qodo managed tools, cross-repo coupling, repos not checked out locally — with distinct triggers like "which repos depend on X". However, common triggers such as "how does X work" and "where is X defined" would also naturally fire general local code-exploration skills, so overlap risk is minor rather than minimal — anchor 4, not 5.

4 / 5

Total

18

/

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

Path

skills/qodo-codebase-wisdom/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.