CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

using-superpowers

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

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

A well-structured, actionable instruction skill with an explicit decision flow and appropriately placed one-level-deep references. Its main weakness is redundancy: the core invocation rule is repeated across three formats, inflating token cost without adding information.

DimensionReasoningScore

Conciseness

The core 1% rule is restated three times (the EXTREMELY-IMPORTANT block, 'The Rule' section, and the dot graph which duplicates the prose flow), which is unnecessary padding. Not 2 because sections like Red Flags, Instruction Priority, and Skill Types each carry distinct, non-redundant value; not 4 because the triple restatement and 13-row rationalization table could be tightened.

3 / 5

Actionability

Concrete, executable guidance throughout: exact announce phrasing ("Using [skill] to [purpose]"), 'Create TodoWrite todo per item', platform-specific tool access instructions, and an explicit skill-priority ordering. Not 5 because some guidance remains abstract (e.g., 'Check your platform's documentation') and there is no worked example of invoking a specific skill.

4 / 5

Workflow Clarity

The dot graph lays out an explicit decision sequence from message receipt to response, with an escape hatch ('If an invoked skill turns out to be wrong for the situation, you don't need to use it'). Not 5 because there is no verification step confirming the skill's steps were followed; not 3 because the sequence is fully explicit and coherent.

4 / 5

Progressive Disclosure

The body is short and well-sectioned, and the reference to references/codex-tools.md is clearly signaled and one level deep (file verified to exist). Minor gap: references/gemini-tools.md exists in the bundle but is never referenced from the body, which instead defers to 'GEMINI.md'. Not 3 because structure and signaling are otherwise good.

4 / 5

Total

15

/

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 clearly states both what the skill does and when to use it, but the universal 'starting any conversation' trigger gives it maximal conflict risk with every other skill, and the trigger vocabulary is generic. The 'what' is stated in meta terms rather than as concrete capabilities.

Suggestions

Narrow the trigger from 'starting any conversation' to specific situations (e.g., 'Use at session start before handling the first user request, or when deciding whether a skill applies to a task') to reduce conflict with every other skill.

State capabilities as concrete actions, e.g., 'Establishes skill-discovery workflow: checking for applicable skills, invoking them via the Skill tool, and announcing usage before responding'.

Add natural trigger keywords users would say, such as 'use a skill', 'which skill applies', or 'skill workflow', to improve trigger-term coverage.

DimensionReasoningScore

Specificity

Names the domain ('how to find and use skills') and 1-2 concrete actions ('requiring Skill tool invocation before ANY response including clarifying questions'), but coverage is narrow and the phrasing is meta rather than a list of specific actions. Not 4 because it does not list several distinct concrete capabilities.

3 / 5

Completeness

Explicitly answers both: what ('establishes how to find and use skills, requiring Skill tool invocation') and when ('Use when starting any conversation'). Not 5 because the 'what' is abstract and meta compared to the anchor's concrete trigger-phrase specificity; not 3 because the 'when' is explicit, not weakly implied.

4 / 5

Trigger Term Quality

Includes some relevant keywords ('skills', 'Skill tool', 'starting any conversation', 'clarifying questions') but they are generic and miss natural variations a user would actually say. Not 2 because the terms are on-domain and real rather than pure jargon; not 4 because coverage lacks synonyms and concrete trigger phrases.

3 / 5

Distinctiveness Conflict Risk

The trigger 'Use when starting any conversation' is universal, so this skill fires alongside virtually every other skill, creating high overlap risk. Not 1 because its actual domain (skill-invocation discipline) is distinct from task-oriented skills.

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

valeriibeck-star/claude-skills

Path

skills/using-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.