CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

gitnexus-debugging

Use when the user is debugging a bug, tracing an error, or asking why something fails. Examples: "Why is X failing?", "Where does this error come from?", "Trace this bug"

Quality

73%

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

A strong, information-dense skill body: nearly everything is executable guidance specific to the GitNexus tooling, with a clear workflow, explicit validation and staleness-recovery loops, and a worked example. The main weaknesses are minor redundancy around repo-binding/freshness guidance and small consistency gaps in tool parameter names.

DimensionReasoningScore

Conciseness

The body is dense with non-obvious operational knowledge (repo-binding pitfalls, staleness semantics, relationTypes filtering, "Omitted references are not absent references") and explains nothing Claude already knows. It is not a 5 because repo-binding and index-freshness guidance is repeated across three sections ('Bind the repository first', the checklist, and the example) and could be consolidated.

4 / 5

Actionability

Concrete, mostly copy-paste-ready calls with parameters and sample outputs for query, context, trace, cypher, and list_repos, plus a runnable terminal command (`node .gitnexus/run.cjs analyze`). It is not a 5 because of minor gaps: `trace` is shown with `from_uid`/`to_uid` in one place and `from`/`to` in another (inconsistent parameter names), and `detect_changes` is mentioned in a table without any call example.

4 / 5

Workflow Clarity

Clear numbered sequence (steps 0–4) mirrored by a checklist and a fully worked example, with explicit validation checkpoints (confirm root cause in source/tests, preserve UNKNOWN/partial warnings, state repo and index freshness), a feedback loop (staleness → re-analyze → retry with precise re-analysis conditions 'behind'/'diverged'), and a stop-and-ask rule for ambiguity. This matches the top anchor: explicit validation, error recovery, and a checklist.

5 / 5

Progressive Disclosure

The skill is self-contained with well-organized, clearly headed sections (When to Use, Bind, Workflow, Checklist, Focus, Patterns, Tools, Example) and no buried or nested references — no references/, scripts/, or assets/ bundle files exist. It is not a 5 because at ~150 lines the per-tool parameter documentation (e.g., the trace semantics and filtered-context options) is substantial enough that it could be split into a one-level-deep reference file to slim the overview.

4 / 5

Total

17

/

20

Passed

Description

52%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 has excellent trigger phrasing with natural, quotable user utterances and a clear 'Use when' clause, but it describes only when to use the skill, not what the skill does. Adding the concrete mechanism and capabilities (GitNexus code-graph queries, caller/callee tracing, root-cause analysis) would lift specificity, completeness, and distinctiveness simultaneously.

Suggestions

State the 'what' explicitly, e.g., 'Traces bugs to root causes by querying a code graph for callers, callees, and call chains (GitNexus)', before the 'Use when' clause.

Add missing natural trigger synonyms such as 'root cause', 'crash', 'exception', 'stack trace', or 'what changed' to broaden keyword coverage.

Mention the distinctive angle (code-graph/navigation-based debugging rather than running the code) so it does not collide with generic debugging skills.

DimensionReasoningScore

Specificity

The description names the debugging domain ("debugging a bug, tracing an error, or asking why something fails") but lists no concrete capabilities — it never states what the skill actually does (e.g., GitNexus code-graph root-cause tracing, querying callers/callees). This matches the anchor 'Names the domain but actions are minimal or generic'; it is not a 3 because there is no explicit list of 1-2 concrete actions the skill performs.

2 / 5

Completeness

The 'when' is explicit and well done ("Use when the user is debugging a bug, tracing an error...") with concrete trigger phrases, but the 'what' is only weakly implied — the description never states what the skill does or how (code-graph based root-cause analysis via GitNexus). This mirrors the incompleteness of the score-3 anchor (one half clear, the other missing/weak), and is not a 4 because the 'what' is absent rather than merely imprecise.

3 / 5

Trigger Term Quality

Strong natural phrases users would actually say: "debugging", "bug", "tracing an error", plus directly quoted example utterances ("Why is X failing?", "Where does this error come from?", "Trace this bug"). It falls short of a 5 because common synonyms like "crash", "exception", "stack trace", "root cause", or "regression" are missing.

4 / 5

Distinctiveness Conflict Risk

The debugging triggers are somewhat specific ("Trace this bug", "Where does this error come from?") but the description omits anything distinctive about the skill's approach, so it would compete with any generic or language-specific debugging skill. It fits 'Somewhat specific but could still overlap with similar skills'; not a 4 because nothing in the text distinguishes it from closely related debugging skills.

3 / 5

Total

12

/

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

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