CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

codebase-exploration

Use when exploring, understanding, or answering questions about a Repowise-indexed codebase, including architecture, where code is implemented, how a module works, or which files are relevant before reading source.

Quality

91%

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

100%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 is an exemplary lean routing guide: concrete call signatures with exact parameters, a sequenced flow with decision branches, explicit trust-signal checkpoints, and terse error-recovery paths. It assumes Claude's competence throughout and contains no padding or over-explanation.

DimensionReasoningScore

Conciseness

The body is lean and dense with Repowise-specific facts ('Skip it once you have the map', 'Cheaper than Read + offset math', 'a row without one is path::name') and explains nothing Claude already knows. The 'Recommended flow' adds confidence-branching and batching strategy rather than restating the table, so every token earns its place.

5 / 5

Actionability

Guidance is copy-paste ready with exact parameter names and values — 'get_context(targets=["<symbol>"], include=["references"])', 'get_change_risk(revspec="<base>..HEAD")', 'get_symbol("path/to/file.py::Name")' — plus exact error strings and fallback slash commands. For an instruction-only skill this fully satisfies the executable-guidance anchor.

5 / 5

Workflow Clarity

A clear 4-step recommended flow with explicit decision branches (high confidence → answer and cite; medium/low → follow best_guesses into get_context, then get_symbol), an explicit validation section ('Trust signals — verify when… Otherwise the response is current — act on it'), and error-recovery feedback loops (empty results → fall back to get_context; MCP unavailable → CLI slash commands). The skill is read-only, so the destructive/batch validation cap does not apply.

5 / 5

Progressive Disclosure

No bundle files exist and none are needed at this size; the body is well organized into four clearly signaled sections (tool routing table, recommended flow, trust signals, error handling) with no nested or buried references and no broken file links, making it easy to navigate as a single-level document.

5 / 5

Total

20

/

20

Passed

Description

78%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, natural-sounding 'Use when…' trigger clause and a distinctive Repowise-scoped niche. Its main weakness is that the 'what' side states activities (exploring, understanding, answering questions) rather than concrete capabilities, leaving the value the skill actually delivers implicit.

Suggestions

State the capability, not just the activity — e.g., '…using Repowise MCP tools that return documentation, ownership, history, decisions, and code-graph context for a codebase', which would raise both specificity and completeness.

Add a few natural trigger synonyms such as 'onboarding to a repo', 'code walkthrough', or 'finding callers or dependencies' to broaden keyword coverage.

Include the change-impact use cases the body supports ('what breaks if X changes') so trigger coverage matches the skill's actual scope.

DimensionReasoningScore

Specificity

Lists several concrete scenarios — 'architecture, where code is implemented, how a module works, or which files are relevant' — matching the 'several specific actions; minor gaps' anchor. It is not 3 (well more than 1-2 concrete items) nor 5 (the verbs 'exploring, understanding' are abstract and capabilities the body covers, like change risk and decision history, are missing).

4 / 5

Completeness

Both parts are present: an explicit 'Use when…' trigger clause with concrete conditions, and a 'what' ('exploring, understanding, or answering questions… including architecture…'). The 'what' never states the capability or mechanism (e.g., returns documentation, ownership, history, graph context), so it does not reach the explicit both-parts anchor 5; it is above 3 because the 'when' is explicit rather than implied.

4 / 5

Trigger Term Quality

'How a module works', 'where code is implemented', and 'which files are relevant' are phrases users naturally say when they need this skill. Good coverage, but common synonyms like 'onboarding to a repo', 'code walkthrough', or 'who owns this code' are missing, so it falls short of the comprehensive anchor 5.

4 / 5

Distinctiveness Conflict Risk

The qualifier 'Repowise-indexed codebase' carves out a clear niche with a distinct trigger, so it is unlikely to fire for generic code-exploration or search skills. This matches the 'clear niche with distinct triggers; minimal conflict risk' anchor.

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