CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

oma-debug

Diagnose a reproducible failure, fix its cause, and verify the regression. Use for crashes, incorrect behavior, and failing tests.

61

Quality

77%

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 ./.agents/skills/oma-debug/SKILL.md

The canonical home for this skill is oma-debug in first-fluke/oh-my-agent

SKILL.md
Quality
Evals
Security

Quality

Content

60%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 presents a coherent, well-sequenced debugging workflow with genuine feedback loops and failure recovery, and it appropriately defers detail to labeled reference files. However, heavy meta-framework scaffolding dilutes token efficiency, and the guidance stays largely abstract — concrete commands, reproduction examples, or template snippets are absent because they live entirely in un-bundled resources/ files.

Suggestions

Collapse the duplicated meta sections ("Intent signature" vs "When to use", the Actions/SSL-primitive table vs the Scenes flow) into a single statement of triggers and workflow to cut padding.

Inline one or two concrete artifacts — e.g., a minimal reproduction-command pattern, a sample bug-report template entry, or a short checklist excerpt — so the skill is actionable even when resources/ files are unavailable.

Consolidate the References section (deduplicate entries already cited in Dependencies, group ../_shared/ vs resources/ paths) and make each reference's purpose label consistent.

DimensionReasoningScore

Conciseness

Meta-framework scaffolding ("Intent signature", "Control-flow features", "Scenes", the "SSL primitive" table) pads the body and duplicates content — "When to use" restates "Intent signature" and the Actions table restates the Scenes flow — so it is mostly efficient but could be tightened, not merely minor trimming.

3 / 5

Actionability

Some concrete guidance exists (Serena tool names find_file, search_for_pattern, get_symbols_overview, find_symbol; "run the smallest reproduction command first"), but most directives are abstract ("Isolate root cause and reject unsupported hypotheses") with no executable commands or examples inlined — the checklists and templates are all deferred to resources/ files not present in the bundle.

3 / 5

Workflow Clarity

The Entry → PREPARE/ACQUIRE/REASON/ACT/VERIFY/FINALIZE sequence is clear, with explicit feedback loops ("If the first fix fails verification, return to root-cause analysis"), failure/recovery paths, exit criteria, and guardrails; it falls short of a 5 because verification steps are named scenes rather than explicit commands or checkpoints.

4 / 5

Progressive Disclosure

The body is an overview with one-level-deep references that carry purpose labels ("Checklist (pre-submit self-verification)", "Error recovery"), but the reference list mixes ../_shared/ and resources/ paths, repeats references already cited in Dependencies, and no bundle files exist to verify the targets, leaving minor organization gaps.

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

A strong description: it pairs a concise three-action capability statement with an explicit, natural-language trigger clause. The main gaps are missing common trigger synonyms (bug, error, traceback) and slight breadth in "incorrect behavior" that could cause overlap with adjacent QA/test skills.

DimensionReasoningScore

Specificity

"Diagnose a reproducible failure, fix its cause, and verify the regression" lists three concrete actions covering the debug workflow, matching the several-specific-actions-with-minor-gaps anchor; it stops short of comprehensive coverage (e.g., root-cause documentation, regression-test authoring) needed for a 5.

4 / 5

Completeness

It explicitly answers both what ("Diagnose a reproducible failure, fix its cause, and verify the regression") and when ("Use for crashes, incorrect behavior, and failing tests") with concrete trigger phrases, mirroring the anchor-5 example structure; it is not a 4 because the when-clause is already explicit and specific.

5 / 5

Trigger Term Quality

"Use for crashes, incorrect behavior, and failing tests" provides natural phrases users would say, but omits common variations such as "bug", "error", "exception", or "traceback", so it fits good-coverage-with-a-few-missing-terms rather than comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

The debugging niche ("reproducible failure", "verify the regression") is clearly distinguishable from feature-building or review skills, but "incorrect behavior" and "failing tests" leave minor overlap risk with test-writing and QA skills, fitting the mostly-distinct anchor rather than the minimal-conflict anchor.

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

first-fluke/oh-my-agent

Path

.agents/skills/oma-debug/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.