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

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 ./src-tauri/experts/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, highly actionable behavioral skill with a clear decision workflow diagram and properly offloaded platform references. Its main cost is repetition — the core invocation rule is restated three times — plus a dangling unreferenced bundle file and inconsistent heading hierarchy.

Suggestions

State the 1%-chance rule once (in 'The Rule' section) and trim the redundant restatement in the EXTREMELY-IMPORTANT block and the dot graph node labels, keeping only the flow structure.

Reference references/gemini-tools.md in the Platform Adaptation section alongside copilot-tools.md and codex-tools.md so no bundle file is orphaned, and normalize heading levels (the h1 'Using Skills' appears mid-document under h2 sections).

DimensionReasoningScore

Conciseness

The core 1%-chance rule is stated three times ('If you think there is even a 1% chance... you ABSOLUTELY MUST invoke the skill', 'Even a 1% chance a skill might apply means that you should invoke the skill to check', and again in the dot graph), so the document could be tightened. It stays above anchor 2 because most sections (Red Flags table, Instruction Priority, Skill Priority) each carry distinct behavioral value rather than padding.

3 / 5

Actionability

Guidance is concrete and executable for a behavioral skill: 'Use the `Skill` tool', 'Never use the Read tool on skill files', the announce template "'Using [skill] to [purpose]'", 'Create TodoWrite todo per item', and platform-specific tool names (skill, activate_skill). It falls short of anchor 5 only through minor gaps like the vague 'Check your platform's documentation for how skills are loaded' and the absence of a worked example.

4 / 5

Workflow Clarity

The dot graph sequences the full workflow with decision branches ('Might any skill apply?', 'Already brainstormed?') and a recovery path ('If an invoked skill turns out to be wrong for the situation, you don't need to use it'). Not a destructive or batch operation, so no validation cap applies; it misses anchor 5 because error recovery is a single sentence rather than an explicit validate-fix-retry loop.

4 / 5

Progressive Disclosure

Platform tool mappings are appropriately offloaded to real one-level-deep references ('see references/copilot-tools.md... references/codex-tools.md'), and both referenced files exist in the bundle. Minor gaps keep it below anchor 5: references/gemini-tools.md is present in the bundle but never referenced in the body, and heading levels jump from '## Platform Adaptation' to '# Using Skills'.

4 / 5

Total

15

/

20

Passed

Description

47%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 what the skill does and when to use it, with a concrete third-person statement of its core mandate. Its weaknesses are the single generic trigger condition ('starting any conversation') that a user would never say naturally, and the resulting near-universal trigger scope that conflicts with every other skill.

Suggestions

Add concrete trigger phrases users or harnesses would actually encounter, e.g. 'Use at session start, before the first response, or when deciding whether a skill applies to a task' — broadening beyond the single 'starting any conversation' condition.

Clarify the distinct niche in the description itself (e.g. 'bootstrap skill that governs skill discovery and invocation discipline') so it is distinguishable from domain skills despite its universal trigger.

Mention the additional concrete capabilities the body covers (skill priority ordering, platform tool mapping) to raise specificity from 1-2 actions toward comprehensive coverage.

DimensionReasoningScore

Specificity

The description names its domain and two concrete actions — 'establishes how to find and use skills' and 'requiring Skill tool invocation before ANY response including clarifying questions' — but coverage is partial, omitting skill priority and platform adaptation covered in the body. It matches the anchor for 1-2 concrete actions better than anchor 4's 'several specific actions with minor gaps'.

3 / 5

Completeness

Both parts are explicit: what ('establishes how to find and use skills, requiring Skill tool invocation before ANY response') and when ('Use when starting any conversation'). The 'when' clause is present but generic rather than concrete trigger phrases, so it sits at anchor 4, clearly above anchor 3 (weak/missing when) but below anchor 5's concrete triggers.

4 / 5

Trigger Term Quality

The only trigger condition is 'starting any conversation', which is not a phrase a user naturally says when they need this skill, and no synonyms or variations are offered. This matches anchor 2 (one or two generic keywords, missing natural phrases) rather than anchor 3, which expects a broader set of relevant keywords.

2 / 5

Distinctiveness Conflict Risk

'Starting any conversation' fires on every conversation, creating high overlap risk with virtually every other skill, even though the bootstrap function itself is a distinct niche. This lands at anchor 2 (very broad, high overlap risk) — above anchor 1 because the described function is specific, below anchor 3 because the trigger scope is universal.

2 / 5

Total

11

/

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

arwei944/codeg

Path

src-tauri/experts/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.