CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

diagnosing-superpowers

当一次 superpowers 会话出了问题、你的人类伙伴想知道原因时使用——重复劳动、无视计划、磕磕绊绊、结果质量差、某个技能没触发、"太慢了"、"为什么这么贵"、"它到底在干什么"——或者想给 superpowers 维护者整理一份 bug 报告;适用于当前会话,或按 id / 路径指定的过往会话,任何工具均可

Quality

83%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

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.

The SKILL.md body itself is exceptional — dense, actionable, with a fully gated seven-step workflow including an explicit scrub/audit feedback loop. The bundle as shipped undermines it: nearly every templates/ and prompts/ file the body depends on is missing, so progressive disclosure breaks down and several steps cannot actually be executed.

Suggestions

Ship the missing bundle files: templates/ (case.md, report.md, issue.md, bundle-README.md) and prompts/ (analyst-common.md, the seven dimension prompts, scrub.md, scrub-audit.md, similar-session.md), so every path referenced in the body resolves.

Reference references/redaction-policy.md from the body (or remove it) — it is currently an orphan file that the redaction workflow in step 6 never points to.

Add a short bundle map (one-line listing of templates/, prompts/, references/ contents) near the top or in the 工作流 section so the file structure is discoverable even before the missing files are restored.

DimensionReasoningScore

Conciseness

Lean and efficient throughout: ~90 lines of dense instructions with zero concept explanations, no padding, and two compact tables (速查, 危险信号) that compress guidance instead of lengthening it. Every line instructs rather than describes — matches the anchor-5 example of a skill that assumes Claude's competence.

5 / 5

Actionability

Concrete, executable guidance dominates: exact paths (~/.superpowers/diagnosing-superpowers/<session-id>/), named prompt files per dimension, explicit commands (zip -r / tar -czf), named redaction levels (skeleton/evidence/full), and precise conditions per step. Not 5 because steps 2, 3, 4, 6 and 7 depend on templates/ and prompts/ files that are absent from the bundle, so execution stalls at those points as shipped.

4 / 5

Workflow Clarity

Seven numbered steps with explicit per-step conditions (第 5–7 步只在各自注明的条件下执行), explicit validation gates (丢弃没有 path:line 的发现; scrub → scrub-audit loop repeated until CLEAN; 核对被引用的内容实际能证明什么), approval gates before archiving or filing issues, and a dangerous-signals checklist that anticipates drift. This matches the anchor-5 feedback-loop pattern exactly.

5 / 5

Progressive Disclosure

The body signals one-level-deep references cleanly, but scored against the actual bundle most navigation targets are broken: only references/ exists (4 files), while the ~14 referenced files under templates/ and prompts/ (case.md, report.md, issue.md, bundle-README.md, analyst-common.md, the seven dimension prompts, scrub.md, scrub-audit.md, similar-session.md) do not exist, and references/redaction-policy.md is present but never referenced from the body. The promised disclosure structure is largely absent, which is below anchor 3's 'references present but not clearly signaled'.

2 / 5

Total

16

/

20

Passed

Description

81%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, information-dense description with best-in-class trigger phrasing (verbatim user complaints) and a well-defined niche. It is held back slightly by a second-person phrase that trips the voice rule and by a "what" side that leans on the scenario instead of naming the skill's core actions.

Suggestions

Rewrite in third person (e.g. 当用户想知道…原因时 instead of 你的人类伙伴想知道原因) to satisfy the voice rule and recover the specificity penalty.

Name 1-2 core actions in the what-clause, e.g. 读取磁盘上的会话记录,产出带 path:line 证据的诊断报告,以取代仅靠场景暗示的做法。

State the primary deliverable explicitly (evidence-cited diagnosis report and optional bug report) so the what-side matches the explicitness of the when-side.

DimensionReasoningScore

Specificity

The trigger side is richly concrete ("重复劳动、无视计划、磕磕绊绊、结果质量差、某个技能没触发" plus scope "按 id / 路径指定的过往会话,任何工具均可"), but the action side names only "整理一份 bug 报告" — the core analysis actions (reading transcripts, producing evidence-cited findings) are absent, matching anchor 3-4. The second-person phrase "你的人类伙伴想知道原因" additionally incurs the rubric's −1 voice penalty, landing the score at 3.

3 / 5

Completeness

Both parts are present: the "what" (diagnose what went wrong in a superpowers session, compile a bug report for maintainers) and an exceptionally explicit "when" (当…时使用 with a concrete symptom list). It sits between anchors 4 and 5 rather than at 5 because the what-side stops short of naming what the skill actually does — it never mentions reading session transcripts or producing the evidence-backed findings that the body delivers.

4 / 5

Trigger Term Quality

Verbatim user complaints are quoted directly ("太慢了"、"为什么这么贵"、"它到底在干什么") alongside symptom phrases ("某个技能没触发", "无视计划", "重复劳动") and the bug-report intent — exactly the natural language a user would say, with synonym-level coverage. Not 4 because no common variation of these complaints is missing.

5 / 5

Distinctiveness Conflict Risk

A clear niche (diagnosing superpowers sessions) with distinct, verbatim trigger phrases that no other plausible skill would claim — minimal conflict risk.

5 / 5

Total

17

/

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

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

frontmatter_unknown_keys

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

Warning

Total

13

/

16

Passed

Repository

jnMetaCode/superpowers-zh

Path

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