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

84%

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.

A highly actionable skill body with copy-paste-ready commands, a clear narrow-then-fetch workflow, and well-conditioned one-level-deep references. Its main costs are token redundancy across the auth/version/update sections and runtime policy detail that lives inline instead of in reference files.

Suggestions

Consolidate the version-probe and provenance instructions, each currently restated across 'Runtime compatibility gate', 'Quick start', and 'Configuration', into a single section referenced from the others.

Move the inline runtime policy detail (skill-update-notice handling and the sandbox auth diagnostic) into the references/ directory alongside the Windows guides, keeping only a one-line conditional pointer in SKILL.md.

Reorder sections to follow execution order (path choice → gate → preflight → routing → fetch → deliver) and move the 'Handle a skill update notice' section after the core workflow so the reader can follow the sequence linearly.

DimensionReasoningScore

Conciseness

There is no concept padding Claude already knows, but instructions repeat across sections: the version probe appears in "Runtime compatibility gate", "Quick start", and "Configuration"; the Windows-shell reference is linked twice ("Execution" and the gate); and "Choose the execution path", "Preflight", and "Sandbox auth diagnostic" carry overlapping auth-policy prose. Anchor 3 ("mostly efficient but could be tightened") fits — the redundancy is more than the minor instances of anchor 4, but every sentence is skill-specific rather than the padded explanations of anchor 2.

3 / 5

Actionability

Quotes: "qodo read codebase grep --repo owner/repo --pattern \"chargeCard\" --json", "qodo read cross-repo relations --repo owner/repo --json", "confirm its exact name, flags, with `qodo read tools <group> [<tool>] --json`". The Quick start commands are copy-paste ready, tool-name verification is itself an executable command, the routing table maps tasks to tool groups, and the Examples section covers the find/plan/debug cases end to end — matching anchor 5.

5 / 5

Workflow Clarity

Quotes: "run `<qodo> --version` exactly as shown... FIRST", "Empty or `truncated: true` → narrow once and retry", "An `MT-TOOL-LOOP` error means stop and change approach, not retry". The sequence (path choice → version gate → preflight auth/repo resolution → route → narrow-then-fetch → deliver) is clear with explicit feedback loops and validation checks. It falls short of anchor 5 because reading order does not map to execution order — the "Handle a skill update notice" section interrupts, and investigation-start guidance is nested inside "Choose the execution path" — so the workflow must be reassembled by the reader. The destructive/batch cap does not apply: the skill is strictly read-only.

4 / 5

Progressive Disclosure

The three references — [manual-update procedure](references/skill-updates.md), [shell guidance](references/windows-shells.md), [launcher recovery](references/windows-launcher.md) — all exist, are one level deep (no nested references), and carry explicit conditional read triggers ("Read only for CLI commands in PowerShell or Git Bash on Windows"). This matches anchor 4 rather than 5 because substantial runtime policy (update-notice handling, the sandbox auth diagnostic, the compatibility-gate detail) is inlined in SKILL.md itself rather than split out the way the Windows material is, so the main file is not a lean overview.

4 / 5

Total

16

/

20

Passed

Description

87%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 excellent trigger-phrase coverage and a fully explicit what/when structure. Its only real weakness is that several trigger phrases are generic enough to invite overlap with ordinary local code-exploration workflows, only partially mitigated by the remote-repo and cross-repo scoping.

DimensionReasoningScore

Specificity

Quotes: "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". Several concrete, domain-spanning capabilities are named, but they are stated at goal level rather than operation level (no mention of search, PR-history lookup, blame, or cross-repo relation retrieval), so it matches anchor 4 rather than the fully operation-concrete anchor 5. It is well above anchor 3 because multiple specific actions cover the domain comprehensively.

4 / 5

Completeness

Both parts are explicit: the "what" is "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" is "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", followed by concrete trigger phrases. This matches anchor 5 exactly.

5 / 5

Trigger Term Quality

Quotes: "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". Ten natural phrases users would actually say, covering synonyms and variations across question-answering, planning, debugging, and impact analysis — a clear match to anchor 5's comprehensive coverage.

5 / 5

Distinctiveness Conflict Risk

Quotes: "especially for a repo you don't have checked out or work spanning repos" gives a distinct niche, but generic triggers like "where is X defined", "explain this service", and "plan the change for X" would naturally fire on routine local code tasks that ordinary code tools handle, creating overlap risk with generic code-exploration and code-review skills. This fits anchor 3 ("could still overlap with similar skills") better than anchor 4, since the mitigation only partially scopes the broad trigger list.

3 / 5

Total

17

/

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

kiro-power/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.