CtrlK
BlogDocsLog inGet started
Tessl Logo

using-superpowers

Use when starting any conversation - establishes how to find and use skills, requiring skill invocation before ANY response including clarifying questions

57

Quality

65%

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/using-superpowers/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

75%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 lean, well-structured behavioral skill: concrete rules, an exact announcement format, a rationalization table, and clean one-level platform references that all resolve to real files. The main gaps are mild redundancy in the red-flags table, no actual mechanism for discovering skills despite the description claiming one, and one orphaned bundle file (gemini-tools.md) not surfaced in the body.

Suggestions

Trim the 12-row Red Flags table to the 4-5 genuinely distinct rationalization patterns — entries like 'This is just a simple question', 'This doesn\'t count as a task', and 'I\'ll just do this one thing first' restate the same excuse and dilute the table's impact.

Add the missing skill-discovery step the description promises: a line on how to enumerate or look up available skills (e.g., where the skill list lives or how to search it) so the 'find' half of 'find and use skills' is actionable.

Add references/gemini-tools.md to the Platform Adaptation list (or remove the file) so the body's reference list matches the actual bundle contents.

DimensionReasoningScore

Conciseness

The body is tight and purposeful — 'Invoke relevant or requested skills BEFORE any response or action' and the priority mapping ('"Let\'s build X" → superpowers:brainstorming first') carry real weight per token. It falls short of 5 because the 12-row Red Flags table contains near-duplicate entries (e.g. 'This is just a simple question' / 'This doesn\'t count as a task' / 'I\'ll just do this one thing first') and the EXTREMELY-IMPORTANT block repeats its mandate three ways ('This is not negotiable. You cannot rationalize your way out of this.'), which could be trimmed without loss.

4 / 5

Actionability

The guidance is concrete and executable for an instruction-only skill: an exact announcement format ('Using [skill] to [purpose]'), a concrete todo rule ('If it has a checklist, create a todo per item'), specific priority examples, and verifiable platform file paths. It misses a 5 because despite the description promising it 'establishes how to find and use skills', the body never says how to discover which skills exist (no command, list, or lookup step) — a real gap for the skill's core claim.

4 / 5

Workflow Clarity

The single decision workflow is clearly sequenced (check for skills → invoke before responding → announce → follow with todos), with an explicit recovery path ('If it turns out wrong for the situation, you don\'t have to use it') and an explicit precedence rule in the User Instructions section. No validation checkpoints are needed since this is neither destructive nor batch, so the score-3 cap does not apply; the only gap keeping it from 5 is that the Skill Priority examples cover just two cases without stating how to resolve other multi-skill conflicts.

4 / 5

Progressive Disclosure

The body is well-sectioned (~60 lines) with clearly signaled, one-level-deep references: 'If your harness appears here, read its reference file' followed by six named files, all of which exist in references/ and contain no nested references. It falls short of 5 because references/gemini-tools.md is present in the bundle but never referenced from the body — an orphaned file indicating drift between the body and the actual bundle.

4 / 5

Total

16

/

20

Passed

Description

55%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.

The description has an explicit and unambiguous 'Use when...' clause with a clear behavioral mandate, but its trigger is conversation-start timing rather than anything a user would naturally say, and it overlaps with every skill by design. The 'what' is concise but under-specifies what the skill actually establishes.

Suggestions

Broaden trigger coverage with natural phrasings users actually say, e.g. 'Use when starting any conversation, session, or new task that may involve skills' — the current single trigger relies entirely on timing rather than user language.

Sharpen the 'what' to name the skill's actual mechanisms (e.g., 'requires invoking relevant skills before any response, sets skill priority order, and lists rationalization red flags to avoid') so the capability surface is explicit rather than implied by 'establishes how to find and use skills'.

Frame the skill explicitly as a session-bootstrap meta-skill ('a mandatory first-step discipline that runs before task-specific skills') to reduce perceived conflict with every other skill that triggers in the same conversation.

DimensionReasoningScore

Specificity

The description names its domain ("find and use skills") and two concrete actions ("establishes how to find and use skills", "requiring skill invocation before ANY response"), matching the anchor for 1-2 concrete actions without comprehensive coverage. It is above the score-2 anchor because 'requiring skill invocation before ANY response including clarifying questions' is a specific, testable behavior, but it doesn't enumerate the several specific actions of the score-4 anchor.

3 / 5

Completeness

Both parts are present: 'what' ("establishes how to find and use skills, requiring skill invocation before ANY response") and a very explicit 'when' ("Use when starting any conversation... before ANY response including clarifying questions"). It falls short of the score-5 anchor only because the 'what' is thinner — 'establishes how to find and use skills' doesn't state what it actually establishes (a priority rule, rationalization red flags, platform adaptation).

4 / 5

Trigger Term Quality

It includes a relevant, explicit trigger ("Use when starting any conversation") but misses natural variations and synonyms users would say — no mention of 'skills', 'superpowers', or session-start synonyms. It sits between anchor 2 (generic keyword coverage) and anchor 4 (good coverage with a few natural terms missing), leaning closer to 3 since the single trigger is at least precise and unambiguous.

3 / 5

Distinctiveness Conflict Risk

"Use when starting any conversation" is maximally broad by design — the trigger condition fires alongside every other skill in every session, matching the score-2 anchor ('very broad; high overlap risk with many similar skills'). It avoids a score of 1 only because it is not a generic task-skill description that would be confused for another capability; it is clearly a session-bootstrap meta-skill.

2 / 5

Total

12

/

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
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.