CtrlK
BlogDocsLog inGet started
Tessl Logo

oma-debug

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

61

Quality

71%

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 ./skills/oma-debug/SKILL.md
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 is a well-structured debugging spec with a genuinely clear workflow, explicit verification and recovery paths, and an exemplary labeled References section. Its weaknesses are a layer of non-actionable meta-scaffolding (scene names, SSL primitive tables, duplicated trigger lists) that spends tokens without instructing, and thin executable content beyond one placeholder search snippet. Referenced resource files are not present in the bundle, which limits verifiable navigation.

Suggestions

Cut the meta-scaffolding: drop the 'Scheduling' header, the PREPARE/ACQUIRE/REASON/ACT/VERIFY/FINALIZE scene labels, and the Actions table's abstract 'SSL primitive' column — the Entry/Transitions/Guardrails sections already carry the same instructions in actionable form.

Make the canonical workflow executable: replace `<error-message-or-symbol>` and 'run the smallest reproduction command' with concrete patterns (e.g., `rg -n "<error text>" src/` and a concrete test-then-fix-then-rerun command sequence) so the guidance is copy-paste ready.

Deduplicate the trigger and resource lists — 'Intent signature' vs 'When to use' and 'Dependencies' vs 'References' each state the same information twice; merge them into one section each.

DimensionReasoningScore

Conciseness

The body is mostly terse tables and bullets with no explanation of concepts Claude already knows, but structural redundancy adds tokens: "Intent signature" duplicates "When to use", "Dependencies" duplicates the References list, and the PREPARE/ACQUIRE/REASON/ACT/VERIFY/FINALIZE scene list restates the Entry/Transitions content. This fits 'mostly efficient but could be tightened' rather than anchor 4, which requires only minor trims.

3 / 5

Actionability

Concrete elements exist (the `rg` snippet, specific output path `.agents/results/bugs/`, six imperative guardrails), but the largest section — the Actions table with abstract "SSL primitive" labels like `CALL_TOOL`/`INFER`/`NOTIFY` — describes rather than instructs, and the canonical workflow uses a placeholder (`<error-message-or-symbol>`) with generic 'run the smallest reproduction command' direction. This is 'some concrete guidance but incomplete', below anchor 4's mostly-executable bar.

3 / 5

Workflow Clarity

The Structural Flow gives a clear Entry → six-scene sequence → explicit VERIFY step ('Re-run failing and related checks') with feedback loops ('If the first fix fails verification, return to root-cause analysis') and a dedicated failure-and-recovery section, matching anchor 4. It falls short of anchor 5 because verification commands remain generic ('project test commands') rather than concrete checkpoints, and the checklists live only in referenced files.

4 / 5

Progressive Disclosure

The body stays at overview level and closes with a well-signaled, one-level-deep References section where each file gets a purpose label (e.g., 'Checklist (pre-submit self-verification): resources/checklist.md'), matching anchor 4's good structure. Not anchor 5: none of the referenced files (resources/*.md, ../_shared/core/*) exist in the provided bundle, so navigation cannot be verified end-to-end, and some process detail inlined in the body arguably belongs in those resources.

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: concise, third-person, and it explicitly covers both capability and triggers. The main gap is keyword breadth — several natural debugging terms (bug, error, stack trace, exception) are missing from the trigger clause. Brevity and clarity are well above the bad examples and comparable to the good ones.

DimensionReasoningScore

Specificity

"Diagnose a reproducible failure, fix its cause, and verify the regression" names three concrete, distinct actions (diagnose, fix, verify), matching the 'several specific actions; minor gaps in coverage' anchor. Not a 5 because coverage stops short of the full debugging surface (e.g., root-cause documentation, regression-test authoring) that the body actually performs.

4 / 5

Completeness

The description explicitly answers both questions: 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, matching the top anchor. It is not a 4 because the 'when' clause is explicit and trigger-bearing rather than vague or merely implied.

5 / 5

Trigger Term Quality

"Use for crashes, incorrect behavior, and failing tests" provides natural phrases users would say, but common variations like "bug", "error message", "stack trace", "exception", or "debug" are absent. Good coverage with a few natural terms missing fits anchor 4; it is above anchor 3 because the included terms are genuinely user-spoken rather than jargon.

4 / 5

Distinctiveness Conflict Risk

The failure-fixing niche with triggers like "crashes" and "failing tests" is mostly distinct from feature or review skills, with only minor overlap risk against closely related testing/error-recovery skills. Clear niche triggers with a small overlap surface fits anchor 4 rather than anchor 5's 'minimal conflict risk'.

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