CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

debugging

Runs a hypothesis-driven debugging loop across any language or binary, escalating to orthogonal oracle angles and locking the fix with a failing test. Use for crashes, silent failures, hangs, wrong responses, memory leaks, async misbehavior, or reverse engineering.

Quality

84%

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

The canonical home for this skill is debugging in code-yeongyu/lazycodex

SKILL.md
Quality
Evals
Security

Quality

Content

77%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 index-style skill: a clearly sequenced 11-phase loop with explicit validation gates, and a progressive-disclosure structure where every link resolves to a real one-level-deep reference file. The one real weakness is repetition — the mandate to read the references is hammered out in multiple emphatic blocks that could be consolidated without losing force.

Suggestions

Consolidate the repeated 'read the references' exhortations (the 🚨 section, the gate rule paragraph, the 'If you cannot honestly say...' line, and the closing tools paragraph) into a single authoritative statement to cut padded emphasis.

Trim duplicated framing between the header note ('Ninety percent of what you need to know lives in references/') and lines like 'The references are the skill. This file is an index.' — one of these suffices.

DimensionReasoningScore

Conciseness

The index-only design is efficient and the gotcha blurbs (e.g. 'tsx + node inspect CLI has a silent source-map failure') are non-obvious value, but the 'read the references' exhortation is repeated roughly five times ('READ THE REFERENCES. THIS IS NOT OPTIONAL', 'Every reference below is mandatory', the gate rule, 'If you cannot honestly say you just opened the reference... open it now', 'Failing to use these tools... is a process failure'), which is padded emphasis that could be tightened to one statement. It sits at the anchor of mostly efficient with some unnecessary repetition, not the 'minor instances' level of a 4.

3 / 5

Actionability

The body gives mostly executable guidance: a copy-paste-ready discriminator pipeline ('du -h ./target' plus "strings -n 12 ./target | rg -iE 'bun|node_modules|webpack|...'"), a concrete gate rule, a numbered 'What to Do Right Now' sequence, and precise per-phase entry points. It is not a 5 because most actual commands live in the reference files, so the body itself contains only a few executable snippets rather than examples covering the common cases.

4 / 5

Workflow Clarity

The 11-phase loop (0–10) is clearly sequenced with an explicit per-phase reference, and validation checkpoints are explicit: root cause confirmed only when 'toggling the suspected cause toggles the bug', the fix 'locked by a failing proof', cleanup verified by 'git diff shows only fix + test', and 'four evidence gates before declaring done'. Feedback loops are built in (Oracle Triple 'after 2 consecutive failed rounds', flaky-triage read before Phase 2), matching the anchor for clear sequence with explicit validation steps and feedback loops.

5 / 5

Progressive Disclosure

Scored against the actual bundle: the body is a pure index and every cited path (6 runtimes, 6 tools, 9 methodology files, references/scripts/dap.mjs) exists exactly where linked, one level deep with no orphaned or buried references. Situation-to-file mapping tables (runtime table, specialist-tool table, phase table, cross-cutting table) make navigation trivial, matching the anchor for a clear overview with well-signaled one-level-deep references.

5 / 5

Total

17

/

20

Passed

Description

87%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 strong description: it answers what and when explicitly, uses third person, and enumerates natural trigger terms users would say when they need debugging help. The only soft spot is jargon ('orthogonal oracle angles') and a few missing common synonyms like 'bug', 'stack trace', or 'segfault'.

Suggestions

Add one or two of the most common user phrasings — e.g. 'bugs', 'stack traces', or 'flaky tests' — to the 'Use for' list to round out trigger coverage.

Translate 'escalating to orthogonal oracle angles' into a plainer concrete capability (e.g. 'escalating to parallel expert analyses after failed rounds') so the action reads as concrete rather than methodological jargon.

DimensionReasoningScore

Specificity

The description lists several specific actions — 'Runs a hypothesis-driven debugging loop', 'escalating to orthogonal oracle angles', 'locking the fix with a failing test' — with concrete mechanism (test-locked fix) rather than generic 'helps debug' language. It is not a 5 because 'orthogonal oracle angles' is methodological jargon rather than a plain concrete capability, leaving minor gaps versus the comprehensive anchor.

4 / 5

Completeness

Both halves are explicit: what it does ('Runs a hypothesis-driven debugging loop... locking the fix with a failing test') and when to use it ('Use for crashes, silent failures, hangs, wrong responses, memory leaks, async misbehavior, or reverse engineering') with seven concrete trigger scenarios. This matches the anchor that clearly answers both what AND when with concrete trigger phrases; score 4 would require the 'when' to be less explicit than this enumerated list.

5 / 5

Trigger Term Quality

Natural trigger phrases users would actually say are well covered: 'crashes', 'silent failures', 'hangs', 'memory leaks', 'async misbehavior', 'reverse engineering', plus 'debugging'. Not a 5 because common variations users also say — 'bug', 'error', 'stack trace', 'segfault', 'exception', 'flaky' — are absent.

4 / 5

Distinctiveness Conflict Risk

It carves a clear niche (hypothesis-driven debugging, oracle escalation, regression-test-locked fixes) with distinct triggers that separate it from adjacent skills like code review, testing, or profiling. Only 'wrong responses' is mildly broad, but it is framed within a debugging trigger list, so conflict risk is minimal.

5 / 5

Total

18

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 26 deeper-than-1-level

Warning

referenced_paths_exist

Referenced path issues: 53 deeper-than-1-level

Warning

Total

14

/

16

Passed

Repository

code-yeongyu/oh-my-openagent

Path

packages/shared-skills/skills/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.