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/gitnexus-debugging/SKILL.md
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, dense operational guide: concrete tool calls with expected outputs, a numbered workflow with verification and recovery steps, a symptom-pattern table, and a worked end-to-end example. Its only weaknesses are minor redundancy between the Workflow, Checklist, and Example sections and a slightly long single-file layout.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence — no padding about what debugging is, and every tool section shows a concrete call with expected output. Minor redundancy: the Checklist section restates the Workflow steps and the worked example reuses the same symbols (validatePayment, fetchRates) already shown in the Tools section, which could be trimmed. Fits anchor 4 ('efficient; minor instances of over-explanation that could be trimmed') better than 5 ('every token earns its place').

4 / 5

Actionability

Fully concrete, copy-paste-ready guidance: exact tool invocations with arguments (query, context, trace), an executable Cypher statement, expected outputs for each call, a terminal recovery command for the stale-index case (`node .gitnexus/run.cjs analyze`), and a complete worked example ending in an identified root cause. This matches anchor 5 ('fully executable; copy-paste ready code or commands; specific examples cover the common cases').

5 / 5

Workflow Clarity

The workflow is clearly sequenced (query → context → read process resource → cypher if needed), backed by a checklist with an explicit verification step ('Read source files to confirm root cause'), a feedback loop for error recovery ('If "Index is stale" → run node .gitnexus/run.cjs analyze'), documented no-path behavior for trace, and a symptom-to-approach table. Matches anchor 5 ('clear sequence with explicit validation steps; feedback loops for error recovery; checklists for complex processes').

5 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are all absent) and the skill needs none; sections are flat, clearly labeled (When to Use, Workflow, Checklist, Debugging Patterns, Tools, Example), and all content is appropriately inline. It scores 4 rather than 5 because the body is ~97 lines — above the under-50-line simple-skill threshold where well-organized sections alone merit a 5 — so the single-file inline structure is good but not maximally disclosed.

4 / 5

Total

18

/

20

Passed

Description

43%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 is a strong trigger — explicit 'Use when' guidance with natural example phrases users would say — but it omits the 'what' entirely: no concrete capability or distinguishing mechanism is stated. It reads as trigger-only guidance with a generic action vocabulary.

Suggestions

Add a 'what' clause before the 'Use when' clause stating concrete capabilities, e.g. 'Locate bug root causes by querying and tracing code call graphs with GitNexus. Use when the user is debugging...'.

Include common trigger synonyms users say during debugging, such as 'stack trace', 'crash', 'exception', or 'root cause', in the trigger list or examples.

Mention the distinguishing mechanism (call-graph / execution-flow analysis of the codebase) so the skill does not compete with generic debugging assistance on every 'why does X fail?' request.

DimensionReasoningScore

Specificity

The description names the domain ("debugging a bug, tracing an error, or asking why something fails") but lists only generic user activities rather than concrete actions the skill performs — nothing about GitNexus, code-graph queries, call-chain tracing, or root-cause analysis is stated. It matches anchor 2 ('names the domain but actions are minimal or generic') and not 3, which requires 1-2 concrete skill-performed actions.

2 / 5

Completeness

The 'when' is explicit and strong ('Use when the user is debugging a bug, tracing an error, or asking why something fails') but the 'what' is entirely absent — the description never states what the skill does. This matches anchor 2 exactly ('only when is present without what'), and not 3, which requires a clear 'what'.

2 / 5

Trigger Term Quality

Natural trigger phrases are well covered: "debugging", "tracing an error", "why something fails", plus example phrases "Why is X failing?", "Where does this error come from?", "Trace this bug" — all things users would actually say. Not 5 because common synonyms like "stack trace", "crash", "exception", or "root cause" are missing.

4 / 5

Distinctiveness Conflict Risk

The debugging/tracing niche is somewhat specific and the example phrases are natural, but the description gives no distinguishing capability (e.g., code-graph-based analysis via GitNexus), so a generic debugging request could trigger this skill or a competing debugging skill equally. Fits anchor 3 ('somewhat specific but could still overlap with similar skills'); not 4 since no distinct mechanism is named.

3 / 5

Total

11

/

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