CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

diagnosing-bugs

面向棘手缺陷和性能回退的诊断循环。适用于用户说 “diagnose” / “debug this”,或报告某些东西 broken、throwing、failing、slow 时。

Quality

80%

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/engineering/diagnosing-bugs/SKILL.md
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 disciplined, well-sequenced six-phase debugging process with explicit completion conditions, checklists, and feedback loops throughout — workflow clarity is exemplary. The prose is efficient and highly actionable, with only minor trimming and file-split opportunities.

DimensionReasoningScore

Conciseness

The body is dense, instruction-only prose that assumes competence and explains no basic concepts; the 134 lines carry real guidance for a six-phase process. A few rhetorical/motivational sentences ("构建正确的 feedback loop,bug 就修好了 90%", "tight 的调试超能力") could be trimmed, matching anchor 4 rather than the fully lean anchor 5.

4 / 5

Actionability

Highly concrete for an instruction skill: ten named loop-construction techniques (Playwright/Puppeteer, curl, diff against known-good snapshots, git bisect run), a copy-paste hypothesis format template, a specific [DEBUG-a4f2] log-prefix convention, and a real executable script reference. Most guidance is executable but many techniques describe the approach rather than giving runnable commands, so anchor 4 fits better than 5.

4 / 5

Workflow Clarity

Six phases are explicitly sequenced, each with a stated completion condition, checklists (Phase 1/2/6), and built-in feedback loops: run loop to red, minimize with re-runs after each cut, diff-verify forced mutations before trusting a red test, and re-run the original Phase 1 loop after the fix. This squarely matches anchor 5 (explicit validation steps, error-recovery loops, checklists).

5 / 5

Progressive Disclosure

Scored against the actual bundle: the single bundle file (scripts/hitl-loop.template.sh) exists, is referenced clearly at its point of use, one level deep, and the body is well-sectioned per phase. It falls short of anchor 5 because the ten-item loop-construction catalog is inlined detail that could live in a references/ file to keep SKILL.md a tighter overview.

4 / 5

Total

17

/

20

Passed

Description

70%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 well-formed description with an explicit 'use when' clause and natural trigger phrases in third-person voice. Its main weakness is a thin 'what': the single phrase 'diagnostic loop' leaves the skill's concrete capabilities unenumerated.

Suggestions

Enumerate 2-3 concrete capabilities in the 'what' clause (e.g., build a fast failing reproduction loop, rank and falsify hypotheses, write a regression test) so specificity matches the strength of the 'when' clause.

Add a few common trigger synonyms such as 'crash', 'error', 'regression', or "doesn't work" to broaden natural keyword coverage.

DimensionReasoningScore

Specificity

The description names its domain ("棘手缺陷和性能回退" — tricky defects and performance regressions) and one concrete action ("诊断循环" — a diagnostic loop), but does not enumerate the loop's actual capabilities (reproduction, minimization, hypothesis testing, instrumentation, regression tests). This matches anchor 3 ('names domain and 1-2 concrete actions, but not comprehensive'); it is not 4 because no plurality of specific actions is listed.

3 / 5

Completeness

Both parts are present: a clear 'what' ("面向棘手缺陷和性能回退的诊断循环") and an explicit 'when' clause ("适用于用户说…时") with concrete trigger phrases. The 'when' fully satisfies anchor 5, but the 'what' is a single unelaborated phrase rather than a concrete capability list, so anchor 4 ('when' explicit, 'what' could be more specific) is the best fit.

4 / 5

Trigger Term Quality

Triggers include the natural phrases users say ("diagnose", "debug this") plus symptom words ("broken、throwing、failing、slow"), giving good keyword coverage. It falls short of anchor 5 because common synonyms like crash, error, exception, "doesn't work", or regression are missing.

4 / 5

Distinctiveness Conflict Risk

The skill carves a clear niche — disciplined diagnosis of stubborn defects and performance regressions — with triggers specific to that scenario. Minor overlap risk remains with generic 'fix this error' or code-review skills, matching anchor 4 rather than 5.

4 / 5

Total

15

/

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

vinvcn/mattpocock-skills-zh-CN

Path

skills/engineering/diagnosing-bugs/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.