CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

codebase-exploration

Use when exploring, understanding, or answering questions about a codebase that has Repowise indexed (a .repowise/ directory in the project root). Activates for "how does X work", "explain the architecture", "where is Y implemented", "what does this module do", or any task that needs an understanding of structure before diving into source files.

Quality

89%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

92%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-structured routing skill: concrete tool signatures with parameters, an explicitly validated workflow with confidence branches and recovery paths, and lean organization with no filler. The only flaw is mild repetition of the Grep/Glob/Read guidance across the intro, table, and flow.

DimensionReasoningScore

Conciseness

The body is dense and assumes Claude's competence (uses "MCP", "bm25", "embedding", "symbol_id" without explanation), but the Grep/Glob/Read guidance is repeated three times — in the intro ("For an exact identifier, string or file name, Grep, Glob and Read are faster"), the table's first row ("An exact identifier, string or file name | Grep, Glob and Read"), and flow step 3 — so minor trimming is possible, matching anchor 4 rather than 5's 'every token earns its place'.

4 / 5

Actionability

Every row gives an executable call with parameters — `get_context(targets=["<symbol>"], include=["references"])`, `get_symbol("path/to/file.py::Name")`, `get_change_risk(revspec="<base>..HEAD")` — plus verbatim error strings ("No repositories found. Run 'repowise init' first.") and exact slash-command fallbacks (`/repowise:ask`, `/repowise:context`), which is copy-paste-ready guidance covering the common cases per anchor 5.

5 / 5

Workflow Clarity

The numbered "Recommended flow" sequences steps with confidence-based branching ("High confidence → answer it, cite the paths"; "medium/low confidence → follow best_guesses[0].file... into get_context"), the "Trust signals — verify when" section supplies explicit validation checkpoints (_meta.stale_warning, medium/low confidence, bm25), and "Error handling" gives feedback loops ("come back empty → ... Fall back to get_context with explicit paths") — clear sequence, validation, and recovery per anchor 5.

5 / 5

Progressive Disclosure

The skill is a single self-contained file with no bundle directories (references/, scripts/, assets/ absent) and no external references, and all ~60 lines are decision-critical routing guidance organized into a tool table, recommended flow, trust signals, and error handling — nothing that belongs in a separate file is inlined, and navigation is easy, satisfying anchor 5.

5 / 5

Total

19

/

20

Passed

Description

81%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 trigger-oriented description: the 'when' is exceptionally explicit with quoted natural trigger phrases and a concrete gating condition (.repowise/ directory), and the niche is clearly distinct. The main weakness is that the 'what' relies on generic activity verbs rather than the skill's concrete capabilities, which live only in the body.

Suggestions

Add 1-2 concrete actions the skill performs to the description itself (e.g., 'Query Repowise MCP tools for architecture summaries, caller graphs, and change risk') to raise specificity.

Lead with a short 'what' clause before the 'Use when...' clause so both halves of completeness are answered with equal concreteness.

DimensionReasoningScore

Specificity

The description names the domain clearly ("a codebase that has Repowise indexed", ".repowise/ directory in the project root") but the only actions stated are generic activity verbs — "exploring, understanding, or answering questions" — with no concrete actions the skill performs (the docs/ownership/history/graph capabilities appear only in the body, not the description). This matches anchor 3 ("Names domain and 1-2 concrete actions, but not comprehensive"), not 4, because no specific action list is given.

3 / 5

Completeness

The 'when' is fully explicit ("Use when exploring...", "Activates for..." with concrete trigger phrases), exceeding anchor 4's weaker 'when', but the 'what' ("exploring, understanding, or answering questions about a codebase") describes the user's task rather than concrete skill actions, falling short of anchor 5's requirement that both halves be answered with equal concreteness.

4 / 5

Trigger Term Quality

Quoted natural phrases — "how does X work", "explain the architecture", "where is Y implemented", "what does this module do" — are exactly what users would say, alongside "exploring, understanding", "codebase", and the ".repowise/" marker. This is comprehensive natural-term coverage per anchor 5, not 4, since common phrasings and synonyms for this domain are all present.

5 / 5

Distinctiveness Conflict Risk

The skill is explicitly gated to "a codebase that has Repowise indexed (a .repowise/ directory in the project root)" — a clear, checkable niche with distinct triggers, so minimal conflict risk with generic exploration skills, matching anchor 5.

5 / 5

Total

17

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

repowise-dev/repowise

Path

plugins/claude-code/skills/codebase-exploration/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.