CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

gitnexus-exploring

Use when the user asks how code works, wants to understand architecture, trace execution flows, or explore unfamiliar parts of the codebase. Examples: "How does X work?", "What calls this function?", "Show me the auth flow"

Quality

83%

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

88%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 excellent operational guide: concrete executable tool calls, a validated workflow with staleness checkpoints and error-recovery rules, and a checklist, all specific to the GitNexus tooling rather than to concepts Claude already knows. The only notable improvement is trimming the guidance repeated across the Workflow, Checklist, and Example sections.

DimensionReasoningScore

Conciseness

The body is dense and GitNexus-specific throughout — every section teaches tool behavior Claude could not know (repo binding, staleness semantics, filter caveats, line-number offset), with no padding or explanations of known concepts. The only trimmable cost is redundancy: bind-once, staleness, and report-repo/freshness guidance are each restated across the Workflow, prose, Checklist, and Example sections.

4 / 5

Actionability

Fully concrete, copy-paste-ready tool calls with real parameters (query with limit/max_symbols/chain_depth, context with response_sections and relationTypes, impact with direction/summaryOnly), pagination via offset/hasMore, a re-analyze command, resource URI patterns, precise read_file line-window arithmetic, and a worked end-to-end example covering the common case — matching anchor 5.

5 / 5

Workflow Clarity

The numbered workflow has explicit validation checkpoints (staleness check with branch/lastCommit and status), an error-recovery rule (re-analyze only for behind/diverged), an ambiguity checkpoint ('If you cannot tell which repository is meant, stop and ask'), instruction to read warning/partial/truncated flags, and a literal checklist — anchor 5's feedback loops and checklists are present. No destructive or batch operations, so no cap applies.

5 / 5

Progressive Disclosure

A well-organized single-file body with clearly labeled sections, a resource table, and no bundle files (none exist on disk and none are referenced in the body). It exceeds the 50-line simple-skill exception, and content like older-server compatibility and filter semantics is inlined where it is decision-critical but could eventually be split into a reference file — matching anchor 4's 'most content appropriately placed, minor organization gaps' rather than 5's clean reference split.

4 / 5

Total

18

/

20

Passed

Description

70%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.

The description excels at trigger guidance — natural phrases with concrete example questions make it highly usable for routing, and both 'what' and 'when' are present. Its weakness is that the 'what' is carried entirely by embedded intent verbs rather than explicitly stating what the skill does (the GitNexus indexed-repository mechanism), which keeps specificity at the middle of the scale.

Suggestions

Add a third-person capability clause before the trigger clause, e.g., 'Explores codebases through a pre-indexed GitNexus repository: finds symbols, traces execution flows, and shows caller/callee context' — this would lift both specificity and completeness.

Broaden trigger coverage with common user phrasings like 'explain', 'walk me through', 'project structure', and 'where is X defined' alongside the existing quoted examples.

Name the concrete deliverables users get (execution traces, caller/callee maps, functional-area clusters) to sharpen distinctiveness from generic code-reading skills.

DimensionReasoningScore

Specificity

Phrases like 'trace execution flows' and 'wants to understand architecture' name several intent-level actions, but the description never states what the skill concretely does (e.g., query a pre-indexed repository for symbols, callers, and execution traces), so it falls short of anchor 4's 'several specific actions' while clearly exceeding anchor 2's minimal actions.

3 / 5

Completeness

Both elements are present: the 'what' is conveyed by the embedded capability verbs ('understand architecture', 'trace execution flows', 'explore unfamiliar parts') and the 'when' is explicit via 'Use when the user asks...'. Not score 5 because the actual mechanism/capabilities (indexed repository queries via GitNexus) remain implicit rather than explicitly stated; not score 3 because the what-verbs are concrete and paired with illustrative questions.

4 / 5

Trigger Term Quality

Natural keywords ('how code works', 'architecture', 'trace execution flows') plus quoted example questions ('What calls this function?', 'Show me the auth flow') give good coverage, but common variations like 'explain', 'walk me through', 'project structure', or 'entry points' are missing, so anchor 5's comprehensive synonym coverage is not met.

4 / 5

Distinctiveness Conflict Risk

A clear codebase-comprehension niche with distinct question-form triggers ('How does X work?', 'What calls this function?') that would rarely fire for unrelated skills, though it retains minor overlap risk with generic code-analysis or documentation skills, matching anchor 4 rather than 5's minimal conflict risk.

4 / 5

Total

15

/

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

abhigyanpatwari/GitNexus

Path

gitnexus-claude-plugin/skills/gitnexus-exploring/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.