CtrlK
BlogDocsLog inGet started
Tessl Logo

codebase-exploration

Explore and understand codebases using SocratiCode semantic search, dependency graphs, and context artifacts. Use when exploring code, understanding architecture, finding functions/types, analysing dependencies, searching database schemas or API specs, or when socraticode/codebase_search tools are available. Activates when the user asks about code structure, wants to find where a feature lives, or needs to understand how code is organised.

74

Quality

93%

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 well-crafted instruction-only skill body: a numbered workflow with a genuine troubleshooting/feedback section, highly specific tool guidance, and clean separation between overview and the real one-level reference file. The only trim opportunity is the mild repetition of the 'search before reading' rationale.

DimensionReasoningScore

Conciseness

The body is lean and dense with tool-specific facts Claude would not know (parameter defaults like 'minScore (default 0.10)', env vars, watcher modes), with no padding explaining concepts Claude already knows. It is not a 5 because the core 'search before reading' principle is restated in section 3 ('Never read a file just to find out if it's relevant') and the milliseconds/negligible-cost point from the intro is repeated ('in milliseconds... far cheaper than opening files speculatively').

4 / 5

Actionability

For an instruction-only skill the guidance is fully executable: exact tool names, concrete parameters ('fileFilter', 'languageFilter', 'minScore (default 0.10)', 'mode: "interactive"'), example queries ('how is authentication handled'), env-var conditions, and a Goal→Tool quick-reference table covering the common cases. Per the rubric's scoring note, absence of code is not penalized when the instruction guidance is this specific.

5 / 5

Workflow Clarity

A clearly sequenced 1–6 workflow (search → graph before imports → read only after narrowing → context artifacts → status troubleshooting → about) with an explicit error-recovery section: 'If search returns no results, the project may not be indexed yet' and stale-result handling that routes to codebase_update, plus conditional watcher/git-mode checkpoints. These feedback loops match the 5 anchor.

5 / 5

Progressive Disclosure

The SKILL.md body is a well-sectioned ~78-line overview that defers full parameter detail to a clearly signaled, one-level-deep reference ('For full parameter details on every tool, see [references/tool-reference.md]'), which exists in the bundle and contains exactly that per-tool parameter detail. Navigation is easy and nothing that belongs in the reference is inlined in bulk.

5 / 5

Total

19

/

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: concrete capabilities, an explicit double trigger clause, and natural user phrasing with tool-name disambiguation. The only weaknesses are minor — a slightly generic code-exploration trigger surface and a couple of unlisted capabilities (e.g., graph visualization).

DimensionReasoningScore

Specificity

The description names the domain and multiple concrete capabilities ('SocratiCode semantic search, dependency graphs, and context artifacts', 'finding functions/types, analysing dependencies, searching database schemas or API specs'). It falls short of a 5 only because capabilities like graph visualization and the interactive explorer are absent from the capability list.

4 / 5

Completeness

It explicitly answers both what ('Explore and understand codebases using SocratiCode semantic search, dependency graphs, and context artifacts') and when, twice over ('Use when exploring code...' and 'Activates when the user asks about code structure...'), with concrete trigger phrases throughout. This mirrors the 5 anchor's structure of concrete 'what' plus explicit trigger guidance.

5 / 5

Trigger Term Quality

Natural trigger phrases are comprehensive and include synonyms users would actually say: 'exploring code', 'understanding architecture', 'finding functions/types', 'code structure', 'where a feature lives', 'how code is organised', 'database schemas', 'API specs', plus an availability trigger ('when socraticode/codebase_search tools are available'). Coverage matches the 5 anchor's breadth including tool names as triggers.

5 / 5

Distinctiveness Conflict Risk

The tool-specific trigger ('when socraticode/codebase_search tools are available') gives it a clear niche, but broad opening triggers like 'exploring code, understanding architecture' overlap with generic code-search/navigation skills, creating minor overlap risk. It is more distinct than the 3 anchor ('somewhat specific but could still overlap') yet not as conflict-free as the 5 anchor's tightly-scoped triggers.

4 / 5

Total

18

/

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
giancarloerra/SocratiCode
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.