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

85%

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

75%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 content is highly actionable, with concrete commands, a routing table, and well-constructed worked examples backed by explicit validation gates and error-recovery loops. Its main weakness is length: repeated policy statements and inline edge-case material make it heavier than a lean SKILL.md needs to be, and the workflow sequence is scattered across interleaved policy sections.

Suggestions

Consolidate the duplicated Windows-shell and auth-denial guidance into a single section (or the existing references) — currently Windows guidance appears in both 'Execution' and 'Runtime compatibility gate', and auth-denial rules are restated across 'Instructions', 'Preflight', and 'Error Handling'.

Move the edge-case policy passages (skill update notices, sandbox auth diagnostic, launcher recovery) into the existing references/ files, keeping SKILL.md to the core MCP/CLI workflow, routing table, and examples.

Present the CLI workflow as one ordered sequence (version probe → whoami → resolve repo → route → narrow-then-fetch → deliver) so the reader doesn't have to reassemble the order from interleaved policy sections.

DimensionReasoningScore

Conciseness

The body never explains concepts Claude already knows and is dense with tool-specific facts, but it runs ~220 lines with repeated material (Windows-shell guidance appears in both Execution and the Runtime compatibility gate; auth-denial handling is restated across Instructions, Preflight, and Error Handling) and padded policy passages (update-notice handling, sandbox auth diagnostic) that could be tightened or moved to references.

3 / 5

Actionability

The Quick start block gives copy-paste-ready commands, the routing table maps task needs to concrete tool groups, and three worked examples show exact queries with expected cited outputs; the MCP path's schema-driven flexibility is explicitly justified, and verification via `qodo read tools <group>` is specified.

5 / 5

Workflow Clarity

Explicit validation gates exist (unadorned `--version` probe marked FIRST, whoami identity check, catalog refresh-once-and-retry) plus feedback loops (empty/`truncated: true` → narrow once and retry), but the sequence must be assembled from interleaved sections (update notices, sandbox diagnostics, guardrails) rather than one coherent ordered flow.

4 / 5

Progressive Disclosure

All three referenced files (skill-updates.md, windows-shells.md, windows-launcher.md) exist, are one level deep, and are clearly signaled with purpose ("only if invocation fails", "for user-requested updates"); however, substantial edge-case policy remains inlined in SKILL.md instead of being split out, so placement is good but not fully appropriate.

4 / 5

Total

16

/

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 that clearly states what the skill does and when to use it, backed by an unusually thorough set of natural trigger phrases. The only weaknesses are minor: capabilities are described at a level above the concrete operations, and a few triggers could collide with general codebase-exploration skills.

DimensionReasoningScore

Specificity

The description names several concrete capabilities ("Understand how code works, how a change was done before, and which repos are coupled", "plan a code change, debug a regression, or scope a fix", "through MCP or the CLI") but stops one level above the actual retrieval operations, so coverage has minor gaps rather than being comprehensive.

4 / 5

Completeness

It explicitly answers both "what" (understand code, prior changes, and repo coupling via 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") with concrete trigger phrases.

5 / 5

Trigger Term Quality

It quotes ten natural user phrases ("how does X work", "where is X defined", "who changed X", "why did X regress / when did it break", "has this been fixed before", "how did we solve X"), giving comprehensive coverage of the ways a user would naturally ask for this skill.

5 / 5

Distinctiveness Conflict Risk

The niche is clear — Qodo-managed codebase/history/cross-repo retrieval, especially for repos not checked out locally — and triggers like "which repos depend on X" are distinctive, but phrases like "how does X work" and "explain this service" overlap with generic code-exploration capabilities.

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

antigravity-plugins/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.