CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

diagnosing-superpowers

Use when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.

Quality

82%

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

73%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 body itself is excellent: an unusually disciplined workflow with explicit conditions, validation loops, approval gates, and anti-drift rules, written with high token efficiency. The score is dragged down by the bundle: the templates/ and prompts/ files the entire workflow pivots on are missing, leaving the reference structure broken in practice.

Suggestions

Ship the templates/ and prompts/ files referenced throughout the workflow (case.md, report.md, issue.md, bundle-README.md, analyst-common.md, the seven dimension files, scrub.md, scrub-audit.md, similar-session.md), or inline minimal versions of the critical ones so the workflow is executable as bundled.

Either reference references/redaction-policy.md from the body (it is the natural place for the redaction levels in step 6) or remove it, so every file in references/ is discoverable from SKILL.md.

Consolidate the overlap between the Hard Rules section and the Red Flags table — several rows restate the same rule (reconstructed statements, unprompted bundles) and could merge into one location.

DimensionReasoningScore

Conciseness

The body is dense and assumes competence — no concept explanations, no padding, with specifics like "One transcript line can be a megabyte" and "gh cannot attach files" earning their tokens. It falls short of 5 because the Red Flags table restates several Hard rules almost verbatim (e.g., reconstructing the partner's statement away, and building the bundle only when asked), which could be consolidated.

4 / 5

Actionability

Guidance is highly concrete: exact file paths ("~/.superpowers/diagnosing-superpowers/<session-id>/"), commands ("zip -r" / "tar -czf"), named analyst dimension files, and explicit approval gates. It is not a 5 because many of the executable artifacts it depends on (templates/case.md, templates/report.md, prompts/analyst-common.md, prompts/scrub.md, etc.) are referenced but absent from the bundle, so the workflow cannot actually be executed as shipped.

4 / 5

Workflow Clarity

Seven steps are clearly sequenced with explicit conditional execution ("Steps 5–7 run only on their stated condition"), and validation is built in throughout: findings without path:line are discarded, the scrub/audit loop repeats "until the audit returns CLEAN", and hard approval gates precede archiving and issue creation. This matches the anchor with feedback loops and checkpoints for a complex process.

5 / 5

Progressive Disclosure

The in-body structure is well designed — a lean overview pointing one level deep to references/, templates/, and prompts/ — but scored against the actual bundle, 11+ of the referenced paths (all of templates/ and prompts/) do not exist, and references/redaction-policy.md exists yet is never referenced in the body. Navigation fails for most pointers, which is worse than the minor organization gaps of a 3.

2 / 5

Total

15

/

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 description with an exceptional, naturally-worded trigger list that quotes real user complaints verbatim. Its only weakness is that the capability side ('what it does') is implied by the symptom list rather than explicitly stated.

DimensionReasoningScore

Specificity

The description names its domain ("a superpowers session went wrong") and one to two concrete actions ("wants to know why" and "build a bug report for the superpowers maintainers"), but most of its length is trigger symptoms rather than what the skill actually does (e.g., reading transcripts or reporting with evidence is never stated). It is not a 4 because the lists of complaints ("repeated work, ignored plans, stumbles...") are triggering conditions, not capabilities of the skill.

3 / 5

Completeness

Both 'when' and 'what' are present and the trigger guidance is explicit ("Use when...") with concrete trigger phrases. It is not a 5 because the 'what' is thinner than the 'when': diagnosing is implied through the complaint list rather than explicitly stating the skill's behavior (e.g., reading session transcripts and reporting findings with evidence).

4 / 5

Trigger Term Quality

It comprehensively includes natural phrases users would literally say: "it took too long", "why is it so expensive", "what is it doing", "a skill that didn't fire", "ignored plans", "repeated work", plus "bug report for the superpowers maintainers". It covers synonyms and complaint variants exhaustively.

5 / 5

Distinctiveness Conflict Risk

"superpowers session" is a clear niche with distinct triggers (transcript diagnosis, bug reports for superpowers maintainers, session identified by id or path), making conflict with other skills minimal.

5 / 5

Total

17

/

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

obra/superpowers

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.