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

78%

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

Fix and improve this skill with Tessl

tessl review fix ./.tessl/plugins/obra/superpowers/skills/diagnosing-superpowers/SKILL.md

The canonical home for this skill is diagnosing-superpowers in obra/superpowers

SKILL.md
Quality
Evals
Security

Quality

Content

66%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 an excellent piece of skill writing: lean, highly structured, with a clearly gated seven-step workflow, validation checkpoints, and a scrub/audit feedback loop. However, as bundled it is incomplete — the templates and analyst prompts it depends on for execution are absent, which breaks both navigation and executability for the core of the workflow.

Suggestions

Ship the missing bundle files: the body depends on 15 files under templates/ (case.md, report.md, issue.md, bundle-README.md) and prompts/ (analyst-common.md plus the seven analyst dimensions, scrub.md, scrub-audit.md, similar-session.md) — add them, or inline the minimal content each step actually needs.

Link references/redaction-policy.md from the body: the export step asks the partner for a redaction level and dispatches scrub prompts, but the policy file that presumably defines the levels is present in the bundle yet never referenced, leaving it undiscoverable.

Define report §7 and §9 inline (one line each, e.g. '§7: superpowers involvement — states involvement and stops') so the verdict and issue steps are actionable even before templates/report.md is added, since steps 4–6 key off those section numbers.

DimensionReasoningScore

Conciseness

The body is dense and imperative with no explanations of concepts Claude already knows — details like "One transcript line can be a megabyte" and "gh cannot attach files" are non-obvious and earn their tokens. It falls short of anchor 5 only because the bundle-gating and no-diagnosis rules are repeated across the workflow steps, Hard Rules, and Red Flags tables, which is minor trimmable redundancy.

4 / 5

Actionability

The orchestration layer is concrete — verified absolute paths, `~/.superpowers/diagnosing-superpowers/<session-id>/`, named redaction levels, `zip -r` or `tar -czf`, "repeating both until the audit returns CLEAN" — but most executable detail (case/report/issue templates, all eleven analyst and scrub prompts) lives in files absent from the bundle, and report sections §7 and §9 are referenced without their defining template. This matches anchor 3's 'concrete guidance but incomplete; missing key details' rather than 4's 'minor gaps'.

3 / 5

Workflow Clarity

Seven numbered steps with explicit conditional gates ("Steps 5–7 run only on their stated condition"), validation checkpoints ("Discard any returned finding without path:line", approval gates before archiving or filing), and a genuine feedback loop (scrub → audit → repeat until CLEAN). The workflow is read-only on session files, so the destructive-operation cap does not apply; this matches anchor 5.

5 / 5

Progressive Disclosure

The four references that do exist (session-discovery, context-safety, github-issues, redaction-policy) are small and one level deep, but 15 of the 19 paths the body cites — all of `templates/` and all of `prompts/` — are missing from the bundle, and the existing `references/redaction-policy.md` is never linked from the body. Scored against the actual bundle per the guidelines, navigation to the core workflow materials is broken, which is below anchor 3's 'could be better organized' but above anchor 1 since what exists is well-signaled and flat.

2 / 5

Total

14

/

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, trigger-rich description that captures exactly how a frustrated user would phrase the problem, with an explicit 'Use when' clause and a clearly bounded niche. Its one weakness is that the skill's own actions are implied through the user's goals rather than explicitly stated.

DimensionReasoningScore

Specificity

The domain is concretely named ("a superpowers session went wrong") with two named deliverables ("wants to know why", "wants to build a bug report for the superpowers maintainers"), but the skill's own actions (reading transcripts, producing evidence-cited reports) are never explicitly stated, matching anchor 3 rather than 4's 'several specific actions'. It is well above anchor 2's bare-domain examples because the symptom list and session-identification details are concrete.

3 / 5

Completeness

The 'when' is explicitly and richly answered ("Use when a superpowers session went wrong… for the current session or a past one identified by id or path"), and a 'what' is present via the two named goals, but the skill's own behavior is embedded in the user's wants rather than clearly stated, so it falls just short of anchor 5's 'clearly and explicitly answers both what AND when'. It is clearly above anchor 3, where 'when' would be missing or weakly implied.

4 / 5

Trigger Term Quality

The description quotes the natural phrases users would actually say — "it took too long", "why is it so expensive", "what is it doing", "a skill that didn't fire", "repeated work", "ignored plans", "stumbles" — giving comprehensive coverage including synonym variations, which matches the anchor-5 example's breadth.

5 / 5

Distinctiveness Conflict Risk

The niche is unambiguous — "superpowers session", "bug report for the superpowers maintainers", "identified by id or path", "on any harness" — so triggers are distinct and overlap risk with other skills is minimal despite the generic-sounding complaint phrases, matching anchor 5.

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

chandler767/WorkJournal

Path

.tessl/plugins/obra/superpowers/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.