CtrlK
BlogDocsLog inGet started
Tessl Logo

diagnosing-bugs

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

69

Quality

83%

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

85%

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 tightly sequenced, highly actionable debugging methodology with explicit validation gates and checklists at every phase, and it appropriately pulls the one mechanical artifact out to a real script file. Its only real weakness is occasional rhetorical padding that slightly undercuts token efficiency.

Suggestions

Trim rhetorical emphasis lines ('要强硬、要有创造力、拒绝放弃' and similar) to tighten the body without losing the directive force.

Consider moving the 10-item 'Ways to construct one' list into a reference file so the core Phase 1 narrative stays lean, with the list as a one-level-deep pointer.

DimensionReasoningScore

Conciseness

The body is dense and mostly assumes Claude's competence without explaining basics, but rhetorical emphasis ('要强硬、要有创造力、拒绝放弃', '盯着代码看多久都救不了你') and some restated phase rationale add padding that could be trimmed.

2 / 3

Actionability

Gives concrete executable guidance throughout — a ranked 10-item list of loop constructions, tagged debug-log prefixes like '[DEBUG-a4f2]', git bisect, and a real referenced harness 'scripts/hitl-loop.template.sh' — well beyond abstract direction.

3 / 3

Workflow Clarity

Six phases are explicitly sequenced with per-phase completion checklists and hard gates ('没有 red-capable command,就没有 Phase 2', '在 reproduce 并 minimise 之前不要继续'), plus a cleanup checklist and feedback loop in Phase 6.

3 / 3

Progressive Disclosure

Content is organized into clear phase sections with a single one-level-deep external reference (scripts/hitl-loop.template.sh) that is clearly signaled and confirmed to exist in the bundle; there is no nested-reference indirection.

3 / 3

Total

11

/

12

Passed

Description

82%

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 cleanly answers both what the skill does and when to invoke it, with natural trigger language and appropriate third-person voice. It is somewhat held back by listing only one abstract action and by broad symptom triggers that could overlap with related skills.

Suggestions

Add one or two concrete actions beyond '诊断循环' (e.g. 'builds a pass/fail feedback loop, bisects regressions, instruments hypotheses') to lift specificity.

Tighten the symptom triggers so they are less likely to collide with general coding or performance skills, e.g. scope 'slow' to 'performance regressions after a change'.

DimensionReasoningScore

Specificity

Names the domain ('棘手缺陷和性能回退') and a core action ('诊断循环') but does not enumerate multiple distinct concrete actions the way the top anchor expects; it stays at the 'names domain and some actions' level.

2 / 3

Completeness

Explicitly states what it does ('诊断循环') and when to use it via an explicit '适用于...时' trigger clause, satisfying both the what and the when with explicit triggers.

3 / 3

Trigger Term Quality

Quotes natural user utterances 'diagnose' / 'debug this' plus symptom words 'broken、throwing、failing、slow', giving strong coverage of phrases a user would actually say.

3 / 3

Distinctiveness Conflict Risk

The 'diagnose'/'debug this' triggers are distinctive, but the broad symptom set 'broken、throwing、failing、slow' could plausibly overlap with general coding or performance skills, so it is not a fully conflict-free niche.

2 / 3

Total

10

/

12

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
vinvcn/mattpocock-skills-zh-CN
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.