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

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.

The body delivers highly actionable, copy-paste-ready CLI guidance with an unusually thorough validation and error-recovery discipline across the MCP and CLI dual paths, and it uses its reference bundle correctly (real files, conditional, one level deep). Its main cost is density and repetition: auth/version policy is restated across several sections, and some edge-case procedures belong in the references directory rather than the main body.

Suggestions

Consolidate the version-probe/auth guidance, currently spread across 'Choose the execution path', 'Runtime compatibility gate', 'Quick start', 'Preflight', and 'Configuration', into a single section the others point back to.

Move the low-frequency edge-case procedures — 'Handle a skill update notice' and the 'Sandbox auth diagnostic' — into the existing references/ bundle (e.g. extend references/skill-updates.md) so the main body keeps only the primary investigation workflow.

Reorder the top-level sections to follow the actual execution sequence (execution path → runtime gate → preflight → route → narrow-then-fetch → deliver) so a reader can follow the workflow linearly without forward references.

DimensionReasoningScore

Conciseness

Every section carries novel, skill-specific policy (no padding with concepts Claude already knows), but the same version-probe/auth policy recurs across "Choose the execution path", "Runtime compatibility gate", "Quick start", "Preflight", and "Configuration", and edge cases like the sandbox auth diagnostic and update-notice handling could be consolidated or pushed to references. Mostly efficient but noticeably could be tightened, matching the anchor just below the efficient band.

3 / 5

Actionability

The Quick start block gives copy-paste-ready commands (`qodo read codebase grep --repo owner/repo --pattern "chargeCard" --json`), the routing table maps task types to tool groups, and three worked examples cover the common cases with concrete commands and expected findings. Even flag uncertainty has an executable resolution path: "confirm its exact name, flags, with `qodo read tools <group> [<tool>] --json`".

5 / 5

Workflow Clarity

A clear sequence (version gate → preflight auth/repo resolution → route to tool group → orient/locate/read → deliver) with explicit validation at each stage and genuine feedback loops: "Empty or `truncated: true` → narrow once and retry", one catalog refresh then stop, `MT-TOOL-LOOP` means "stop and change approach, not retry", and stop conditions for every auth/version failure.

5 / 5

Progressive Disclosure

All three referenced files (references/skill-updates.md, windows-shells.md, windows-launcher.md) exist, are one level deep with no nested references, and are well-signaled with conditional load triggers ("before the first call", "only if invocation fails", "For user-requested updates"). However, rare-path procedures like the update-notice policy and sandbox auth diagnostic remain inline in an already long body, and section ordering (Execution before the runtime gate before Quick start) is slightly scattered — good structure with minor organization gaps rather than the clean overview/split of the top anchor.

4 / 5

Total

17

/

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 with explicit what/when structure and an exceptional set of natural trigger phrases covering question-answering, planning, debugging, and impact-scoping intents. The only weaknesses are mildly abstract capability verbs and trigger phrases that could also fire on generic codebase-exploration skills.

DimensionReasoningScore

Specificity

Lists several specific capabilities — "Understand how code works, how a change was done before, and which repos are coupled" and "answer a question, plan a code change, debug a regression, or scope a fix" — but the verbs stay abstract ("understand", "plan", "scope") rather than naming concrete tool operations like grep, blame, or PR-history lookup. It exceeds the 1-2-action anchor but falls short of the comprehensive concrete-action anchor.

4 / 5

Completeness

Explicitly answers both what ("Understand how code works... using Qodo managed tools through MCP or the CLI") and when ("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"), followed by concrete trigger phrases. This matches the anchor for clearly and explicitly answering both with concrete triggers.

5 / 5

Trigger Term Quality

Ten quoted natural trigger phrases — "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" — with synonym variations. This comprehensively covers the natural phrasings a user would actually say.

5 / 5

Distinctiveness Conflict Risk

The Qodo managed-tools, cross-repo coupling, and not-checked-out-repo angles establish a clear niche, but broadly worded triggers like "how does X work", "where is X defined", and "explain this service" overlap with generic code-comprehension or repo Q&A skills. Mostly distinct with minor overlap risk against closely related skills.

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

packages/qodo/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.