CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

veomni-debug

Use this skill for ANY bug, error, crash, wrong output, loss divergence, gradient explosion, test failure, CUDA error, distributed training hang, checkpoint load failure, or unexpected behavior. Covers both quick fixes (clear root cause) and complex debugging (unclear cause). Trigger: 'fix bug', 'fix error', 'broken', 'crash', 'doesn't work', 'fails with', 'loss NaN', 'training hangs', 'FSDP error', 'OOM'.

Quality

90%

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

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.

An exceptionally strong operational skill body: concrete commands, repo-specific gotchas that Claude could not infer, gated verification at every phase, and checklists for the risky distributed-training cases. The only real lever is density management — the bisect walkthrough and subagent template could move to reference files, and a few redundant sentences could be cut — but nothing here is padding or generic knowledge.

DimensionReasoningScore

Conciseness

The body is dense with load-bearing, non-obvious specifics — the '--active is load-bearing' caveat, the venv-vs-worktree isolation logic, and terse pitfall entries like 'accumulating sharded gradients produces wrong results' — with almost no explanation of concepts Claude already knows. It is not anchor 5 because a few spots could be trimmed: the worktree paragraph states its core point twice, and the 'Track the phases with whatever todo/plan tool' snippet instructs behavior Claude would exhibit anyway.

4 / 5

Actionability

Fully executable throughout: complete uv bisect commands ('uv venv .venv-a', 'VIRTUAL_ENV=.venv-a uv sync --active --extra gpu --dev', freeze/diff comparison), activated reproducer invocations, concrete repo paths ('veomni/distributed/parallel_plan.py', '.agents/knowledge/constraints.md'), 'make quality'/'make patchgen', and a copy-paste subagent prompt template. Placeholders like '<reproducer>' are appropriate parameterization rather than pseudocode, matching the anchor-5 copy-paste-ready shape.

5 / 5

Workflow Clarity

The workflow has explicit validation and feedback loops everywhere: a dispatch table routing to Quick Path vs Full Protocol, a time-based escalation ('If not resolved in 15 min → switch to Full Protocol'), a Phase-3 verification gate with confidence threshold and subagent launch, Phase-4 verify-and-check-collateral steps, a 3-failed-attempt stop condition, and two checklists for complex processes. This matches the anchor-5 combination of clear sequence, explicit validation, and error-recovery loops.

5 / 5

Progressive Disclosure

The single file is well-sectioned with clear headers and signals repo knowledge files at the right moments ('Check constraints first: Read .agents/knowledge/constraints.md'; Phase 5 capture targets), which fits anchor 4's good structure with mostly-clear references. It is not anchor 5 because the ~60-line uv/worktree bisect procedure and the Appendix subagent template are fully inlined where one-level-deep reference files would keep SKILL.md closer to an overview, though the inlined content is at least needed exactly when the skill fires.

4 / 5

Total

18

/

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 with explicit what/when structure and excellent natural trigger coverage spanning colloquial to technical registers. The main weakness is breadth: by claiming any bug or error, it risks firing for generic debugging situations that other skills (or a plain code-review skill) could also own, with only the handful of ML-specific terms marking its true territory.

Suggestions

Narrow the universal claim from 'ANY bug, error, crash... or unexpected behavior' to the skill's real scope (e.g., bugs in VeOmni training, model, and distributed code) so it does not compete with generic debugging skills for every conceivable error.

State one or two concrete debugging actions the skill performs (e.g., 'root-cause investigation, dependency bisecting, and verification') to complement the situation enumeration on the capability side.

Consider dropping the most generic trigger terms ('broken', "doesn't work", 'wrong output') or qualifying them with the domain so they don't claim non-ML debugging contexts.

DimensionReasoningScore

Specificity

The description enumerates many concrete failure modes ('loss divergence, gradient explosion, test failure, CUDA error, distributed training hang, checkpoint load failure') and splits scope by fix complexity ('quick fixes (clear root cause) and complex debugging (unclear cause)'), going well beyond 1-2 concrete items. It falls short of anchor 5 because the enumeration is of triggering situations rather than concrete actions the skill performs — 'complex debugging' itself is generic.

4 / 5

Completeness

Both questions are answered explicitly: what — 'Covers both quick fixes (clear root cause) and complex debugging (unclear cause)'; when — 'Use this skill for ANY bug...' plus a dedicated list of concrete trigger phrases. The anchor-4 shape ('when could be more explicit') does not apply since the when is maximally explicit.

5 / 5

Trigger Term Quality

An explicit 'Trigger:' clause provides comprehensive natural coverage across registers: colloquial ('broken', "doesn't work"), standard ('fix bug', 'crash', 'fails with'), and technical synonyms ('loss NaN', 'training hangs', 'FSDP error', 'OOM'). No common natural variations are conspicuously missing, matching the anchor-5 example's breadth including synonyms.

5 / 5

Distinctiveness Conflict Risk

The claim 'ANY bug, error, crash... or unexpected behavior' is a deliberate maximal land-grab that overlaps with any general debugging or code-fix skill, and generic terms ('test failure', 'wrong output') broaden it further. The ML/distributed-specific triggers ('loss NaN', 'FSDP error', 'OOM') give it a partial niche, so it sits at anchor 3 (somewhat specific but could still overlap) rather than 4.

3 / 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

ByteDance-Seed/VeOmni

Path

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