CtrlK
BlogDocsLog inGet started
Tessl Logo

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"

63

Quality

79%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./.claude/skills/gitnexus/gitnexus-exploring/SKILL.md
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.

An exemplary instruction-only skill body: fully concrete tool calls and resource URIs, a numbered workflow with an explicit staleness checkpoint and recovery command, a checklist, and a worked example — all at under 3KB. The only improvement opportunity is consolidating the triple-rendered workflow (Workflow, Checklist, Example) and dropping the 'When to Use' section that duplicates the frontmatter triggers.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence — no space is spent explaining what a codebase or execution flow is, and the Resources table even budgets token costs per resource. It falls short of anchor 5 because the same workflow is rendered three times (Workflow, Checklist, and the worked Example) and 'When to Use' repeats the frontmatter triggers — minor redundancy that could be trimmed.

4 / 5

Actionability

Everything is executable: exact MCP resource URIs ('READ gitnexus://repos', 'READ gitnexus://repo/{name}/process/{name}'), concrete tool calls ('query({query: "payment processing"})', 'context({name: "validateUser"})'), a runnable recovery command ('node .gitnexus/run.cjs analyze'), and a fully worked end-to-end example covering a common case. This matches anchor 5's copy-paste-ready guidance with specific examples for the common cases.

5 / 5

Workflow Clarity

The workflow is a clearly numbered 5-step sequence with an explicit checkpoint and recovery loop ('If step 2 says "Index is stale" → run node .gitnexus/run.cjs analyze'), a checklist for complex processes, and a grounding step ('Read source files for implementation details'). All operations are read-only, so the destructive/batch validation cap does not apply; this matches anchor 5's explicit validation steps, feedback loop, and checklist.

5 / 5

Progressive Disclosure

No bundle files exist (no references/, scripts/, or assets/ directories), and none are needed — the ~75-line body is appropriately self-contained with well-organized sections (When to Use, Workflow, Checklist, Resources, Tools, Example). The resource table with per-resource token costs effectively implements lazy loading, matching the well-organized-simple-skill pattern the rubric rewards with a 5.

5 / 5

Total

19

/

20

Passed

Description

56%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 trigger-first description with excellent natural-language 'when' cues and quoted example phrases, but it never states what the skill actually does — all capability language is framed as user intent, leaving the 'what' implicit. Adding one third-person sentence of concrete capabilities would lift both specificity and completeness.

Suggestions

Lead with a third-person capability statement, e.g., 'Traces execution flows, maps symbol callers/callees, and surfaces functional areas in indexed codebases using GitNexus context.', so the 'what' is explicit rather than inferred from the trigger clause.

Broaden trigger coverage with common synonyms such as 'explain this code', 'walk me through the flow', or 'onboard to this repo' to move trigger term quality toward comprehensive.

Tighten distinctiveness by scoping the triggers to indexed-repo exploration (e.g., mentioning GitNexus or 'indexed codebase') so generic code questions don't risk mis-triggering it.

DimensionReasoningScore

Specificity

The description names the domain ("code", "architecture", "the codebase") but every action is phrased as a user intent ("asks how code works", "wants to understand architecture", "trace execution flows", "explore unfamiliar parts") rather than as a capability the skill performs. Scoring only what is explicitly stated, this matches 'names the domain but actions are minimal or generic' — it is above anchor 1 because 'trace execution flows' and 'explore' gesture at concrete activity, but below anchor 3 because no concrete skill action (e.g., 'traces execution flows via indexed code context') is explicitly claimed.

2 / 5

Completeness

The 'when' is explicit and strong ("Use when the user asks..." plus concrete example phrases), but the 'what' is only weakly implied — capabilities appear only embedded inside the trigger clause as user wants, with no independent statement of what the skill does. It is above anchor 2 (both a when and a discernible what are present) but below anchor 4, which expects both a clearly stated what and a when; here the what is implicit rather than explicit.

3 / 5

Trigger Term Quality

Strong natural phrasing users would actually say: "asks how code works", "trace execution flows", and quoted examples "How does X work?", "What calls this function?", "Show me the auth flow". This clearly exceeds anchor 3 ('some relevant keywords but missing common variations') and matches anchor 4 — a few natural terms are missing (e.g., 'explain this code', 'walk through', 'onboard to a repo', 'codebase map'), so it falls short of anchor 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

The niche — code comprehension, execution-flow tracing, architecture exploration with quoted triggers like "What calls this function?" — is coherent and mostly distinct from adjacent skills (reviewing, editing, testing). It is above anchor 3 because the trigger phrases are specific rather than generic, but below anchor 5 because broad questions like "What's the project structure?" could overlap with generic code-reading or documentation skills.

4 / 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
mindfold-ai/Trellis
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.