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

60

Quality

69%

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 ./plugins/superpowers/skills/using-superpowers/SKILL.md

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

SKILL.md
Quality
Evals
Security

Quality

Content

67%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 is a well-structured, mostly actionable meta-skill with good reference hygiene and a clear core workflow. Weaknesses are moderate verbosity from repeated emphasis, a missing explanation of how to discover available skills, and an orphaned gemini-tools.md reference.

Suggestions

Add Gemini to the Platform Adaptation list (references/gemini-tools.md exists but is unreachable from the skill).

Consolidate the triple-repeated mandate in EXTREMELY-IMPORTANT into a single statement, and merge overlapping Red Flags rows (e.g., the two 'not a task' variants).

Include one short section or pointer on HOW to discover which skills are available (e.g., where to list them), since that is the skill's stated purpose.

DimensionReasoningScore

Conciseness

The body is mostly directive with little concept explanation, but it could be tightened: the EXTREMELY-IMPORTANT block repeats the same rule three times ("YOU ABSOLUTELY MUST invoke the skill", "YOU DO NOT HAVE A CHOICE", "This is not negotiable"), and several Red Flags rows overlap (e.g., 'This is just a simple question' vs 'This doesn't count as a task'). Not score 2 because it never explains concepts Claude already knows; not score 4 because the redundant emphasis and overlapping table rows are trimmable without losing meaning.

3 / 5

Actionability

The guidance is concrete and executable for an instruction-only skill: an exact announcement pattern ("Using [skill] to [purpose]"), a checklist rule ("If it has a checklist, create a todo per item"), and worked priority examples ("'Let's build X' → superpowers:brainstorming first"). It falls short of score 5 because the body never explains HOW to find available skills — the core capability the description promises — leaving a minor gap.

4 / 5

Workflow Clarity

The single workflow is clearly sequenced: check for skills BEFORE any response or action → invoke matching skill → announce → follow exactly (todos per checklist item), with priority ordering and a plan-mode precondition. Not score 5 because there is no checkpoint or fallback guidance (e.g., what to do when no skill clearly applies, or when a invoked skill turns out wrong mid-use beyond the single sentence); not score 3 because the sequence present is coherent and unambiguous.

4 / 5

Progressive Disclosure

Platform-specific detail is correctly split into one-level-deep, clearly signaled references (references/codex-tools.md, pi-tools.md, antigravity-tools.md, hermes-tools.md — all verified to exist). Not score 5 because references/gemini-tools.md exists in the bundle but Gemini is missing from the platform list, leaving a real file unnavigable from the skill.

4 / 5

Total

15

/

20

Passed

Description

71%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 is complete and clearly written, with an explicit trigger clause and a concrete statement of what the skill does. Its main weakness is distinctiveness: triggering on 'any conversation' maximizes overlap with every other skill, though this appears intentional for a meta-skill.

Suggestions

Consider narrowing the trigger (e.g., 'Use at the start of a session before the first response') so it does not compete with every task-specific skill on every turn.

Add one or two synonym trigger terms (e.g., 'skill check', 'before answering') so natural variations also match.

Briefly enumerate the sub-topics the skill covers (skill priority, rationalization red flags, platform adaptation) to make the 'what' more comprehensive.

DimensionReasoningScore

Specificity

The description names its domain ("how to find and use skills") and one to two concrete actions ("requiring skill invocation before ANY response including clarifying questions"), but it does not comprehensively list what the skill actually covers (skill priority, red flags, platform adaptation). It is above score 2 because the actions stated are concrete, not generic; it is below score 4 because coverage stops at two actions.

3 / 5

Completeness

Both parts are explicit: the 'when' is a concrete trigger clause ("Use when starting any conversation") and the 'what' is stated directly ("establishes how to find and use skills, requiring skill invocation before ANY response including clarifying questions"). Not score 4 because the 'when' is not merely adequate — it is a specific, unambiguous trigger phrase.

5 / 5

Trigger Term Quality

Natural trigger phrases are present: "Use when starting any conversation", "skill invocation", "clarifying questions" — phrasing a user or harness would plausibly match on. It falls short of score 5 because there are no synonyms or variations (e.g., 'beginning a session', 'skill check', 'before answering') to broaden matching.

4 / 5

Distinctiveness Conflict Risk

The trigger "starting any conversation" fires alongside virtually every other skill, creating maximum overlap risk — a deliberate design for a meta-skill, but per the rubric it is very broad with high conflict risk. Not score 1 because the topic itself (skill invocation discipline) is a recognizable niche rather than generic filler; not score 3 because the overlap is with all skills, not just closely related ones.

2 / 5

Total

14

/

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
openai/plugins
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.