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.

A highly actionable, well-referenced instruction body with concrete commands, a routing table, worked examples, and genuine error-recovery loops. Its main costs are token weight: duplicated Windows guidance, inline version pins, and long policy sections that could be externalized to the references directory the skill already uses well.

Suggestions

Deduplicate the Windows shell guidance — keep the single link in '## Execution' and have the '## Runtime compatibility gate' section reference it rather than restating the PowerShell/Git Bash instruction.

Move the conditional-policy blocks ('Handle a skill update notice', 'Sandbox auth diagnostic', and the update-approval half of 'Runtime compatibility gate') into a reference file like references/skill-updates.md, keeping only a one-line trigger and link in SKILL.md.

Replace the hardcoded '--skill-version 1.1.7 --distribution marketplace --host codex' flags in the Quick start whoami example with a short instruction on deriving provenance from the loaded package metadata, so the pinned version does not go stale inline.

DimensionReasoningScore

Conciseness

The body is dense instruction without concept-explainer padding, but it includes unnecessary repetition and tightening targets: Windows shell guidance is given twice (in '## Execution' and again in '## Runtime compatibility gate'), and time-sensitive version pins are inlined ('requires Qodo CLI 2.0.0 or newer', hardcoded '--skill-version 1.1.7 --distribution marketplace --host codex' in Quick start) rather than isolated in an old-patterns/deprecation section. This matches the 3 anchor's 'mostly efficient but could be tightened', exceeding the 2 anchor's padding but not reaching the 4 anchor's 'minor instances'.

3 / 5

Actionability

Mostly executable guidance: a copy-paste Quick start command block, a routing table mapping task types to concrete tool groups and named tools, and three worked examples with real command chains (e.g., 'codebase grep --pattern "chargeCard"' → 'codebase read-file --path src/pay.py --start-line 120 --limit-lines 40'). Held below 5 because the skill itself concedes the tool names are 'illustrative, not guaranteed current' and the provenance flags in the whoami example are hardcoded rather than derived.

4 / 5

Workflow Clarity

A clear multi-step investigation sequence (choose execution path → version gate → preflight auth/repo resolution → route to tool group → orient/locate/read → deliver) with explicit feedback loops: 'Empty or truncated: true → narrow once and retry', a single catalog refresh and schema recheck, and stop conditions in Error Handling. Not the 5 anchor because the sequence is interleaved with policy sections (update-notice handling, sandbox auth diagnostic, compatibility gating) that break linear flow, though the read-only workflow carries no destructive-operation cap.

4 / 5

Progressive Disclosure

All three bundle files exist and are referenced one level deep with purpose-scoped link text ('manual-update procedure', 'shell guidance', 'launcher recovery only if invocation fails'), and Windows/enterprise-update detail is appropriately externalized. Falls short of the 5 anchor because ~230 lines of conditional policy (notice handling, sandbox diagnostics, compatibility gating) remain inline in SKILL.md where a leaner overview with further split-out references would navigate more easily — the 4 anchor's 'minor organization gaps'.

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 with an explicit third-person 'what', a clear 'Use when' clause, and ten natural trigger phrases covering questions, planning, debugging, and cross-repo impact. Its only weaknesses are task-level rather than tool-level action wording and trigger terms that overlap generic code-exploration needs.

DimensionReasoningScore

Specificity

Lists several concrete capabilities — 'how a change was done before, and which repos are coupled', 'answer a question, plan a code change, debug a regression, or scope a fix, using Qodo managed tools through MCP or the CLI' — and uses third-person voice. Falls short of the 5 anchor because actions stay at the user-task level rather than naming the concrete tool operations (grep, blame, PR history, cross-repo relations), leaving minor coverage gaps; clearly above the 3 anchor's '1-2 concrete actions'.

4 / 5

Completeness

Explicitly answers both 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 when ('Use when a task needs to understand a codebase, its history, or how its repos relate') with concrete trigger phrases. Matches the 5 anchor exactly; the 4 anchor's 'when could be more explicit' does not apply.

5 / 5

Trigger Term Quality

Comprehensive natural phrases users would actually say: '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', plus scenario synonyms like 'a repo you don't have checked out or work spanning repos'. Matches the 5 anchor's coverage including synonyms and variations.

5 / 5

Distinctiveness Conflict Risk

Pinned to Qodo managed tools with a distinct niche ('a repo you don't have checked out or work spanning repos'), so mostly distinct with minimal vendor overlap. However, generic triggers like 'how does X work' and 'where is X defined' would also naturally apply to local code exploration skills, leaving the minor overlap risk that defines the 4 anchor rather than the 5 anchor's 'minimal conflict risk'.

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

codex-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.