CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

trace

Use when encountering bugs, test failures, runtime errors, broken builds, or "this doesn't work" reports. Systematic root-cause analysis before any patch — never blind-patches symptoms. Standalone, ends with a final-integration review of the fix. Trigger with /hyperflow:trace, "debug this", "find the root cause", "why is this failing", "this test is broken".

Quality

82%

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

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

A strong, highly operational skill body: every step has concrete dispatch commands, reviewer gates, and failure-recovery behavior, and the worked examples make the flow unambiguous. Its main cost is token efficiency — the step structure is duplicated across the agent map, step sections, and Instructions summary, and doctrine rule citations push comprehension outside the file.

Suggestions

Drop the 'Instructions' summary section (or the 'Per-Step Agent Map' table) — the 7 steps are fully specified in their own sections, and the third restatement costs ~25 lines of context for no new information.

Remove the trailing 'Overview' and 'Output' sections, which restate the frontmatter description and the Output Format section verbatim.

At first use, inline a one-line gloss of DOCTRINE rules 12.2.8 and 14 (e.g., 'atomic = single Worker→Reviewer pair') instead of repeating the bare rule number in every section, so the body does not depend on an external file to be understood.

DimensionReasoningScore

Conciseness

The 7-step workflow is stated three times — the 'Per-Step Agent Map' table, the full step sections, and the 'Instructions' summary — and 'Atomic (DOCTRINE 12.2.8)' is repeated in nearly every section, while the trailing 'Overview' and 'Output' sections restate the frontmatter and Output Format. Nearly all content is operational rather than concept explanation, so it sits above 'noticeably verbose' (2) but below 'efficient with only minor trims' (4).

3 / 5

Actionability

Gives exact dispatch strings ('Searcher — locating bug reproduction in recent changes/tests'), concrete reviewer checklists, verdict enums ('CONFIRMED', 'FALSIFIED ALL', 'PARTIALLY CONFIRMED'), a full worked example transcript, and a copy-paste output-format block — fully executable guidance for an instruction-only skill, with the common cases (failing test, symptom-patch request, intermittent bug) covered by examples.

5 / 5

Workflow Clarity

Seven explicitly numbered steps each gated by a Reviewer, with explicit feedback loops ('Loop back to Step 2 with a broader evidence scope', 'loop Step 5 with the Reviewer's specific objection attached'), loop limits ('After 2 full cycles, surface to user'), and an error-handling table covering repro failure, flakiness, falsified hypotheses, and missing test runner — matching the anchor for clear sequence plus validation, recovery loops, and checklists.

5 / 5

Progressive Disclosure

Core workflow lives in the body with one-level-deep, clearly labeled references to real bundle files ([worker-prompt.md](references/worker-prompt.md), [reviewer-prompt.md](references/reviewer-prompt.md), [memory-system.md](references/memory-system.md), [output-style.md](references/output-style.md)) and an annotated Resources section. Not 5: it also depends on paths outside the bundle ([DOCTRINE.md](../hyperflow/DOCTRINE.md), ../../agents/searcher.md, ../../agents/debugger.md) and repeatedly cites DOCTRINE rule numbers (12.2.8, 14, 18) whose meaning requires following those external links.

4 / 5

Total

17

/

20

Passed

Description

78%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 explicitly states what the skill does and when to use it, with natural quoted trigger phrases a user would actually say. The main gaps are a thin listing of the skill's concrete capabilities and a few missing debugging synonyms.

DimensionReasoningScore

Specificity

Names the debugging domain and 1–2 concrete actions — 'Systematic root-cause analysis before any patch' and 'ends with a final-integration review of the fix' — but omits the skill's other capabilities (reproduction, evidence gathering, hypothesis verification, regression testing). Not 2 because the actions named are concrete rather than generic; not 4 because coverage of what the skill does is incomplete.

3 / 5

Completeness

Explicitly answers both: what — 'Systematic root-cause analysis before any patch — never blind-patches symptoms' — and when, with a 'Use when encountering...' clause plus a second 'Trigger with...' sentence listing concrete trigger phrases. The 'when' is maximally explicit with concrete trigger phrases, matching the top anchor.

5 / 5

Trigger Term Quality

Excellent natural coverage — 'bugs, test failures, runtime errors, broken builds' plus quoted user phrases 'debug this', 'find the root cause', 'why is this failing', 'this test is broken'. Not 5 because common synonyms like 'crash', 'stack trace', 'exception', and 'flaky' are absent; well above 3's 'some relevant keywords'.

4 / 5

Distinctiveness Conflict Risk

The 'Systematic root-cause analysis... never blind-patches symptoms' positioning carves a clear debugging niche distinct from review/deploy skills. Not 5 because the trigger surface ('bugs, test failures, runtime errors, broken builds') is broad enough to overlap a generic fix-the-test or build skill; clearly above 3's 'could still overlap with similar skills'.

4 / 5

Total

16

/

20

Passed

Validation

81%

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

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

frontmatter_unknown_keys

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

Warning

relative_links

Relative link issues: 4 suspicious

Warning

Total

13

/

16

Passed

Repository

jeremylongshore/tons-of-skills-marketplace

Path

plugins/ai-agency/hyperflow/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.