CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

trace

Evidence-driven tracing lane that orchestrates competing tracer hypotheses in Claude built-in team mode

Quality

66%

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/trace/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

63%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 content is a thoughtful, well-structured orchestration protocol with genuinely novel guidance (evidence-strength tiers, falsification rules, rebuttal rounds, convergence detection). Its main weaknesses are redundancy across role-perspective sections and the absence of any progressive disclosure — the full output template and lane detail are inlined rather than split into reference files.

Suggestions

Merge the 'Suggested lead prompt skeleton' into the 'Team-mode orchestration shape' section (or keep only the skeleton) — they cover the same ground.

Move the 'Example final synthesis shape' template to a references/output-template.md file and keep only the 10-item return list inline.

Add one concrete example of spawning a tracer lane in team mode (an actual agent invocation or tool call) to close the actionability gap.

DimensionReasoningScore

Conciseness

The body is mostly non-redundant with Claude's prior knowledge (a bespoke protocol, not explanations of known concepts), but several sections restate each other: the 'Suggested lead prompt skeleton' compresses the 'Team-mode orchestration shape', the 'Example final synthesis shape' expands the 'Leader synthesis contract', and the 'Output quality bar' is generic adjective padding. It is not score 2 because the repetition targets different roles (lead vs. worker vs. output) rather than being pure padding, and not score 4 because those near-duplicate sections are trimmable without losing guidance.

3 / 5

Actionability

As an instruction-only skill it is appropriately actionable without code: numbered orchestration steps, three named default hypothesis lanes, an 8-item worker return structure, and a full output template with a ready-to-use ranked-hypotheses table. Not score 5 because there is no concrete example of how to actually spawn a tracer lane in team mode (e.g., a sample tool call or agent invocation), leaving the central mechanical step abstract.

4 / 5

Workflow Clarity

The 9-step orchestration shape gives a clear sequence, and the rebuttal round plus re-ranking rules act as explicit checkpoints with a feedback loop (rebuttal → re-rank if weakened). Not score 5 because the checkpoints are advisory prompt-level guidance rather than enforced validation, and there is no explicit recovery path if workers return non-conforming output.

4 / 5

Progressive Disclosure

The body is well-sectioned with clear headers, but at ~250 lines everything is inlined in a single SKILL.md — the full 'Example final synthesis shape' template and the detailed lane-3 premise-audit guidance would fit naturally in one-level-deep reference files, and no bundle files exist to offload them. Not score 4 because content that clearly belongs in separate files is inlined; not score 2 because section headers make it navigable rather than a monolithic wall.

3 / 5

Total

14

/

20

Passed

Description

53%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 communicates a distinctive concept but reads more like an internal design label than a user-facing trigger. It lacks any 'use when' guidance and relies on project jargon ('OMC lane', 'tracer') instead of natural trigger phrases users would say.

Suggestions

Add an explicit trigger clause, e.g. 'Use when the user asks why something happened, wants a root cause, or posts an unexpected output/regression to explain.'

Enumerate 2-3 concrete actions in the description (e.g., 'generates competing explanations, gathers evidence in parallel, ranks hypotheses, recommends the next discriminating probe') instead of the abstract 'orchestrates competing tracer hypotheses'.

Replace jargon ('lane', 'OMC', 'tracer') with natural synonyms users would type: 'root cause analysis', 'why did this happen', 'postmortem', 'debug'.

DimensionReasoningScore

Specificity

The description names the domain ("tracing") and one concrete action ("orchestrates competing tracer hypotheses"), but stops there — it does not enumerate the actual operations (restate observation, spawn parallel lanes, rank explanations, propose next probe). It sits at the 'names domain and 1-2 concrete actions' anchor rather than score 4, which requires several specific listed actions.

3 / 5

Completeness

The 'what' is reasonably clear (evidence-driven tracing that orchestrates competing hypotheses), but there is no 'Use when...' clause or equivalent trigger guidance, which caps completeness at 3 per the judging guidelines. Not score 2 because the 'what' half is concrete, not vague.

3 / 5

Trigger Term Quality

Relevant keywords like "tracing", "evidence-driven", "hypotheses", and "team mode" are present, but common natural phrases users would actually say — "root cause", "why did this happen", "debug", "postmortem" — are absent. It is not score 4 because the keyword set is jargon-leaning ('lane', 'tracer') rather than covering natural synonyms.

3 / 5

Distinctiveness Conflict Risk

The niche is fairly distinct — evidence-driven hypothesis orchestration with named tracer agents in team mode — with minor overlap risk against general debugging or code-review skills. Not score 5 because 'tracing' alone could plausibly collide with observability/distributed-tracing skills.

4 / 5

Total

13

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

Yeachan-Heo/oh-my-claudecode

Path

skills/trace/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.