CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

brainstorming

You MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).

1.51x
Quality

76%

Does it follow best practices?

Impact

97%

1.51x

2 of 3 eval scenarios. Add 1 more for a full score.

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills/brainstorming/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

77%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 strong, highly actionable methodology body with an exemplary gated workflow, validation checkpoints, and concrete scripts and budgets. Its two real defects are repetition of the visual-companion and gate rules, and a broken bundle: both referenced companion files (builder-check-prompt.md, visual-companion.md) are absent from the directory, leaving two workflows unexecutable as bundled.

Suggestions

Ship the referenced bundle files (builder-check-prompt.md and visual-companion.md) or inline their essentials — as bundled, both the builder check and the visual companion workflows dead-end at missing files.

Consolidate the visual-companion offer rules into the 'Visual Companion' section and reference it from the other two spots, and state the workflow order once; the current repetition costs tokens without adding guidance.

If the scripts/ directory (server.cjs, start-server.sh, etc.) is the visual companion's implementation, mention those entry points from the body so the server tooling is discoverable.

DimensionReasoningScore

Conciseness

The body is dense, opinionated, and assumes Claude's intelligence (no explanations of concepts Claude already knows), but contains real repetition: the visual-companion offer rules appear in three places ('Show, don't tell', the 'Play It Back' pre-send check, and the 'Visual Companion' section) and the build-gate workflow order is stated twice (intro list and HARD-GATE). This matches 'mostly efficient but could be tightened' rather than the minor-trim level of 4.

3 / 5

Actionability

For an instruction-only skill the guidance is copy-paste ready: word budgets ('about 200 words', '200-300 words'), an exact offer script ('This might be easier if I show you. Want me to open a browser tab with some mockups?'), a worked example dialogue (the bakery website question), concrete tables (Size, Red Flags), and an exact output path ('docs/superpowers/specs/YYYY-MM-DD-<topic>-design.md'). Per the rubric's code-vs-instruction note, the absence of code is not penalized.

5 / 5

Workflow Clarity

A clearly sequenced multi-step process (approaches → design doc → approval → writing-plans) with explicit validation checkpoints: the builder check with three-pile triage, the HARD-GATE approval before any building, a feedback loop (one round of 'theirs' questions, doc updated, then handed over), enumerated exceptions (spikes, opt-outs), and growth handling ('If it grows mid-task, stop, say so, and step up a size').

5 / 5

Progressive Disclosure

In-file structure is good — clear section headers, well-signaled one-level-deep references ('read `visual-companion.md` in this directory', 'dispatch a fresh subagent with `builder-check-prompt.md` in this directory') — but scored against the actual bundle, both referenced files are missing (only server scripts/ exist), so navigation fails exactly where content was split out. This sits between the broken/inlined level of 2 and the well-placed level of 4; the good internal organization holds it at 3 while the dangling references block anything higher.

3 / 5

Total

16

/

20

Passed

Description

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

An unusually effective trigger-only description: it tells Claude exactly when to invoke the skill with rich, natural trigger phrases across domains. Its main defect is that it never states what the skill actually does, and its deliberately maximal breadth ('anything new') creates conflict risk with every other creative-work skill.

Suggestions

Add a 'what' clause, e.g. 'Leads a design conversation — questions, approaches, and a written design doc approved before building' so the description answers both halves of completeness.

Add 'brainstorm' (and 'design discussion') as explicit trigger terms, since a user asking to 'brainstorm an idea' is the most natural invocation and currently matches only implicitly.

Consider scoping 'planning anything new' slightly (e.g. 'before building anything non-trivial') to reduce overlap with implementation and planning skills.

DimensionReasoningScore

Specificity

Enumerates several concrete trigger activities ("creating features, building components, adding functionality, modifying behavior, or planning anything new") across software and non-software domains, matching the 'several specific actions' anchor. Not 5 because it names only when-conditions, never the skill's own actions, and not 3 because the coverage goes well beyond 1-2 actions.

4 / 5

Completeness

The 'when' is explicit and comprehensive ("MUST use this before any creative work... in software or out of it"), but the 'what' — that the skill runs a questioning conversation, lays out approaches, and produces an approved design doc — is entirely absent, matching the anchor-2 disjunct 'only when is present without what'. Scored 3 rather than 2 because the trigger guidance far exceeds the anchor-2 example's specificity, leaving completeness exactly half-addressed.

3 / 5

Trigger Term Quality

Contains natural phrases users would actually say ("creating features", "modifying behavior", "planning anything new", "a talk, a business, a renovation") with good cross-domain coverage. Not 5 because key synonyms are missing — most notably 'brainstorm' itself, plus 'design', 'prototype', and 'new project'.

4 / 5

Distinctiveness Conflict Risk

"planning anything new, in software or out of it" is very broad and would fire ahead of virtually any creative or building skill, creating high overlap risk (anchor 2). It earns anchor 3 instead because the pre-work gate intent (brainstorm before building, not the building itself) is a genuinely distinct niche with distinct trigger framing.

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

obra/superpowers

Path

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