CtrlK
BlogDocsLog inGet started
Tessl Logo

brainstorming

You MUST use this before any creative work - creating features, building components, adding functionality, or modifying behavior. Explores user intent, requirements and design before implementation.

61

1.00x
Quality

63%

Does it follow best practices?

Impact

88%

1.00x

Average score across 1 eval scenario

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./plugins/superpowers/skills/brainstorming/SKILL.md

The canonical home for this skill is brainstorming in obra/superpowers

SKILL.md
Quality
Evals
Security

Quality

Content

70%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 delivers a well-sequenced, highly actionable three-path workflow with explicit approval and review feedback loops — its strongest aspect. It is weakened by heavy repetition of the approval-gate message (including generic design principles Claude already knows) and by progressive-disclosure problems: the referenced visual-companion guide is missing from the bundle and the bundled server scripts are never linked from the skill.

Suggestions

Consolidate the approval-gate rule into the HARD-GATE block and the Red Flags table, and cut or shrink the generic 'Design for isolation and clarity' and 'Working in existing codebases' sections, which restate knowledge Claude already has.

Fix the broken reference: either ship skills/brainstorming/visual-companion.md in the bundle or inline the essential companion instructions and move the detailed guide to a real references/ file that is linked.

Name the actual scripts in the Visual Companion section (e.g. 'run scripts/start-server.sh --open' and scripts/stop-server.sh) so the bundled tooling is discoverable and executable from the skill.

DimensionReasoningScore

Conciseness

Mostly efficient — the path taxonomy, ratchet rule, just-in-time companion offer, and spec self-review are genuinely skill-specific — but the approval-gate rule is restated at least six times (HARD-GATE block, Anti-Pattern section, 7-row Red Flags table, checklist items, 'Terminal states are path-bound'), and 'Design for isolation and clarity' / 'Working in existing codebases' restate general software judgment Claude already has. Not 2 because the majority of the body is original policy rather than padding; not 4 because the gate repetition and generic design sections are noticeable.

3 / 5

Actionability

Concrete and executable for an instruction skill: per-path numbered checklists, copy-paste message templates (the companion offer, the user-review-gate prompt), an exact spec path pattern, and explicit decision tests ('would the user understand this better by seeing it than reading it?'). Not 5 because 'start the server with --open' never names the actual script, even though scripts/start-server.sh exists in the bundle.

4 / 5

Workflow Clarity

Clear sequences for all three paths with explicit validation checkpoints (approval gates, spec self-review, user review gate) and feedback loops for error recovery ('User approves design? no, revise'; spec self-review fix-inline; re-run review on requested changes), plus a flow diagram and checklists. Not 4 because no checkpoint gaps remain — the approval/review gates are exactly the validation the anchor-4 example lacks.

5 / 5

Progressive Disclosure

Section structure and headers are good, but scored against the actual bundle: the single external reference 'skills/brainstorming/visual-companion.md' does not exist in the bundle, and none of the five scripts/ files (server.cjs, helper.js, start-server.sh, stop-server.sh, frame-template.html) are referenced or navigable from the body. Not 4 because a broken reference and an unlinked scripts directory are more than minor organization gaps; not 2 because the body itself is well-organized with clearly signaled sections and nothing is buried two levels deep.

3 / 5

Total

15

/

20

Passed

Description

57%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 strong, explicit trigger guidance with natural user phrasings, but its 'what' statement is thin and it uses second-person voice, incurring the rubric's specificity penalty. Its claim to gate all 'creative work' makes it extremely broad, risking conflicts with nearly every implementation-related skill.

Suggestions

Rewrite in third person and enumerate concrete actions/deliverables, e.g. 'Explores user intent and requirements, proposes 2-3 approaches with trade-offs, and produces a design or written spec. Use before creating features, building components, adding functionality, or modifying behavior.'

Narrow the trigger scope or state exclusions (e.g. 'use for tasks needing a design decision; skip for trivial edits') so it doesn't claim to gate every code change and conflict with implementation/planning skills.

Add common synonyms users would say — 'design', 'brainstorm', 'new project', 'spec' — to the trigger phrase list for fuller natural-term coverage.

DimensionReasoningScore

Specificity

Base score is 3 — it names the pre-implementation design domain and 1-2 actions ('Explores user intent, requirements and design') but no comprehensive action list. The rubric's third-person voice rule applies ('You MUST use this' is second person), reducing specificity by 1 to 2. It is not 1 because it is not pure abstraction like 'Helps with documents'.

2 / 5

Completeness

Both 'what' ('Explores user intent, requirements and design before implementation') and 'when' (explicit trigger guidance covering creative work types) are present. Not 5 because the 'what' is a single thin sentence that doesn't enumerate concrete deliverables (approaches, design doc, spec); not 3 because the 'when' clause is explicit, so the completeness cap for missing trigger guidance doesn't apply.

4 / 5

Trigger Term Quality

'creating features, building components, adding functionality, or modifying behavior' are natural phrases users actually say, giving good keyword coverage. Not 5 because common synonyms and variations ('design', 'brainstorm', 'new project', 'spec') are missing; not 3 because coverage clearly exceeds 'some relevant keywords'.

4 / 5

Distinctiveness Conflict Risk

'before any creative work - ... or modifying behavior' claims to gate virtually every code-change request, creating high overlap risk with writing-plans and any implementation or planning skill. Not 1 because the design-before-implementation niche is real; not 3 because the trigger surface ('any creative work', 'modifying behavior') is broad enough to fire on nearly every task.

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