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

75%

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

Fix and improve this skill with Tessl

tessl review fix ./.claude/skills/gitnexus/gitnexus-exploring/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

81%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 a strong operational skill: a sequenced workflow with a staleness feedback loop, exact resource URIs and tool call syntax with expected outputs, and a concrete worked example. It is lean and well-organized, with only minor redundancy between the When-to-Use/Checklist sections and the workflow, and no progressive-disclosure structure because none is needed at this size.

DimensionReasoningScore

Conciseness

The body is lean: no explanations of concepts Claude already knows, concrete token-cost estimates per resource, and every section carries operational content. Minor trimmable redundancy — the 'When to Use' list largely repeats the frontmatter description, and the Checklist restates the Workflow — keeps it at anchor 4 ('efficient; minor instances that could be trimmed') rather than 5 ('every token earns its place').

4 / 5

Actionability

Concrete, executable guidance throughout: exact MCP resource URIs, tool calls with realistic arguments (query({search_query: "payment processing"}), context({name: "processPayment"})), a remediation command (node .gitnexus/run.cjs analyze), and a fully worked end-to-end example. Small gaps — the full parameter surface of query/context isn't specified and {name} placeholders require the reader to infer substitution — fit anchor 4 ('concrete code or commands with minor gaps') rather than fully copy-paste-ready anchor 5.

4 / 5

Workflow Clarity

A clearly sequenced 5-step workflow where each step states what it yields, an explicit validation checkpoint with a feedback loop ("If step 2 says 'Index is stale' → run node .gitnexus/run.cjs analyze"), and a checklist for verifying the process was followed — matching anchor 5 ('clear sequence with explicit validation steps; feedback loops for error recovery; checklists').

5 / 5

Progressive Disclosure

The skill is a single file with no bundle directories, and the ~74-line body is cleanly sectioned (When to Use, Workflow, Checklist, Resources, Tools, Example) so navigation is easy. It sits just above the under-50-line range where inline-only content scores 5; the Resources table and Tools detail are borderline content that could live in a reference file if the skill grows, which fits anchor 4 ('good structure; most content appropriately placed; minor organization gaps').

4 / 5

Total

17

/

20

Passed

Description

57%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 trigger side of the description is excellent — natural user phrasing with concrete example quotes — but the capability side is missing: the whole text is a single 'Use when' clause and never says what the skill does (GitNexus-indexed exploration via symbol/process queries) or when it applies versus plain code reading. Adding an explicit capability statement and a GitNexus-index precondition would lift both completeness and distinctiveness.

Suggestions

Lead with an explicit 'what' statement before the 'Use when' clause, e.g., 'Explores codebases through a GitNexus index: query symbols, trace execution flows, and view callers/callees without reading every file.'

Mention the GitNexus index (or 'when a repo has been analyzed/indexed') so the skill doesn't trigger for ordinary code-reading questions on unindexed repos — this also improves distinctiveness.

Add a few missing natural trigger synonyms such as 'call graph', 'callers', 'dependencies', or 'walk me through the code' to round out trigger coverage.

DimensionReasoningScore

Specificity

The description names the domain (codebase exploration) and a couple of concrete-sounding actions ("trace execution flows", "wants to understand architecture"), but all verbs are framed as user intents inside the 'Use when' clause rather than as the skill's capabilities. It never states what the skill actually does (query a GitNexus index for symbols/processes/callers), so coverage is not comprehensive — matching anchor 3, not 4.

3 / 5

Completeness

The 'when' is explicit and well-developed ("Use when the user asks how code works..." plus example quotes), but the 'what' is never stated as a capability — the entire description is one 'Use when...' clause with the skill's function only weakly implied by the embedded trigger verbs. Per the guideline to score only what is explicit, this matches anchor 3 ('what missing or only weakly implied') rather than anchor 4 where both are present.

3 / 5

Trigger Term Quality

Strong natural phrases: "how code works", "trace execution flows", "Show me the auth flow", "What calls this function?" — exactly what users say. A few common variations are missing (e.g., "call graph", "callers/callees", "dependencies", "walkthrough"), which fits anchor 4 ('good coverage; a few natural terms missing') rather than the comprehensive anchor 5.

4 / 5

Distinctiveness Conflict Risk

Codebase-understanding questions ("How does X work?") are extremely common and this description would fire for all of them, including on repos without a GitNexus index. It never mentions GitNexus or indexed repos, so it overlaps with generic exploration/review skills — anchor 3 ('somewhat specific but could still overlap with similar skills'), not 4 which requires mostly distinct triggers.

3 / 5

Total

13

/

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

tslateman/shipyard

Path

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