CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

investigate

Systematic debugging with root cause investigation. Four phases: investigate, analyze, hypothesize, implement. Iron Law: no fixes without root cause. Use when asked to "debug this", "fix this bug", "why is this broken", "investigate this error", or "root cause analysis". Proactively suggest when the user reports errors, unexpected behavior, or is troubleshooting why something stopped working.

Quality

78%

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 ./skills/gstack/.agents/skills/gstack-investigate/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

62%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 core systematic-debugging workflow (roughly the last 160 lines) is excellent — clearly phased, validated, and actionable. However, the majority of the file is gstack framework boilerplate (preamble scripting, persona, telemetry onboarding) that inflates token cost without aiding the debugging task and should live in separate shared files. Splitting the framework content out would dramatically improve both conciseness and progressive disclosure.

Suggestions

Move the ~275 lines of framework machinery (Preamble, Voice, AskUserQuestion Format, Completeness Principle, Contributor Mode, Telemetry, Plan Status Footer) into shared reference files or a common include, keeping SKILL.md focused on the systematic debugging workflow.

If the boilerplate must stay bundled, at minimum extract the Voice persona and telemetry opt-in flows into clearly signaled one-level-deep reference files so SKILL.md reads as an overview plus the debugging procedure.

Replace template placeholders like SKILL_NAME, OUTCOME, and <detected-directory> with inline resolved values or a single clearly documented substitution step to make the bash blocks fully copy-paste ready.

DimensionReasoningScore

Conciseness

Roughly 275 of ~475 lines are gstack framework machinery unrelated to debugging — the preamble bash block, the multi-page "Voice" persona section, telemetry opt-in flows, contributor mode, and plan-footer boilerplate — matching the anchor for noticeably verbose with several padded sections. Not 1 because it avoids tutorial-style explanation of concepts Claude already knows; not 3 because the off-topic padding is far more than 'some unnecessary explanation'.

2 / 5

Actionability

The debugging phases give concrete, executable guidance: "git log --oneline -20 -- <affected-files>", the scope-lock bash block, fully written AskUserQuestion scripts, and a copy-paste DEBUG REPORT template — mostly executable with minor gaps. Not 5 because commands depend on external $GSTACK_BIN binaries and contain substitution placeholders (SKILL_NAME, OUTCOME, <detected-directory>); not 3 because there is no pseudocode and the commands are specific and runnable.

4 / 5

Workflow Clarity

Phases 1-5 are clearly sequenced (investigate, pattern analysis, hypothesis testing, implementation, verification) with explicit validation steps — "Reproduce: Can you trigger the bug deterministically?", a regression test that must fail without the fix, "Run the full test suite", and non-optional fresh verification — plus feedback loops (wrong hypothesis returns to Phase 1; the 3-strike rule escalates). This matches the anchor for clear sequence with explicit validation, feedback loops, and checklists; no destructive-operation cap applies since verification is central to the workflow.

5 / 5

Progressive Disclosure

A single 475-line SKILL.md with no references or bundle files; the framework boilerplate (Voice, telemetry flows, contributor mode) is content that clearly belongs in separate shared files but is inlined, matching the anchor for some structure but content that should be separate is inline. Not 4 because nothing is split out or referenced; not 2 because section headers throughout make the document navigable.

3 / 5

Total

14

/

20

Passed

Description

83%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 strong: it uses third person, states concrete capabilities, and pairs them with explicit, naturally-phrased trigger conditions including proactive-use guidance. It directly matches the structure of the rubric's good overall examples. Only minor synonym coverage (e.g., 'crash', 'not working', 'stack trace') keeps trigger quality from full marks.

DimensionReasoningScore

Specificity

"Systematic debugging with root cause investigation. Four phases: investigate, analyze, hypothesize, implement" lists several specific actions (four named phases plus root cause investigation), matching the anchor for several specific actions with minor gaps. Not 5 because the phase names are somewhat generic and capabilities like pattern analysis and regression testing are not enumerated; not 3 because more than 1-2 concrete actions are named.

4 / 5

Completeness

Explicitly answers 'what' ("Systematic debugging with root cause investigation. Four phases... Iron Law: no fixes without root cause") and 'when' ("Use when asked to 'debug this', 'fix this bug', 'why is this broken'...") with concrete quoted trigger phrases, exactly matching the anchor-5 example structure.

5 / 5

Trigger Term Quality

Includes natural user phrases like "debug this", "fix this bug", "why is this broken", "investigate this error", "root cause analysis", plus "reports errors, unexpected behavior, or is troubleshooting" — good keyword coverage, but common variations such as "not working", "crash", or "stack trace" are missing. Anchor 5 requires comprehensive coverage including synonyms; this falls just short.

4 / 5

Distinctiveness Conflict Risk

"root cause analysis", "why is this broken", and "investigate this error" carve out a mostly distinct debugging niche, but "fix this bug" is a common phrase that could also fire for general coding/fix skills — matching the anchor for minor overlap risk with closely related skills. Not 5 because that overlap with generic fix-it requests is non-trivial; not 3 because the bulk of the triggers are specific to debugging and unlikely to collide with unrelated skills.

4 / 5

Total

17

/

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

valeriibeck-star/claude-skills

Path

skills/gstack/.agents/skills/gstack-investigate/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.