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.

71

1.05x
Quality

68%

Does it follow best practices?

Impact

60%

1.05x

Average score across 3 eval scenarios

SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./eval/local/skills/benchmarks/dependency/superpowers/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 an exemplary workflow: ordered checklist, explicit user-approval validation gates, self-review loop, and concrete verbatim scripts for key moments. Its weaknesses are repetition of the hard-gate rule, an overlong Visual Companion section, and a progressive-disclosure gap where the referenced visual-companion.md is missing from the bundle and the bundled scripts are never mentioned.

Suggestions

State the hard gate once (in the HARD-GATE block) and reduce the other three restatements to brief pointers, trimming the Visual Companion section to the offer script plus the browser-vs-terminal test.

Fix the dangling reference to skills/brainstorming/visual-companion.md — either include the file in the bundle or reference the actual bundled scripts (scripts/server.cjs, scripts/start-server.sh) so the detail layer is real and discoverable.

Add one compact example of a proposed approach with trade-offs and a recommendation to make the 'Propose 2-3 approaches' step concretely executable.

DimensionReasoningScore

Conciseness

The no-implementation gate is repeated four times ("Do NOT invoke any implementation skill... until you have presented a design", the anti-pattern section, "The ONLY skill you invoke after brainstorming is writing-plans", and "Do NOT invoke any other skill"), and the Visual Companion section restates the browser-vs-terminal test with worked examples. Mostly efficient, but these padded/redundant passages could be trimmed — anchor 3 rather than 4's 'minor instances'.

3 / 5

Actionability

For an instruction-only skill the guidance is largely executable: an ordered 9-item checklist, an exact spec path (`docs/superpowers/specs/YYYY-MM-DD-<topic>-design.md`), verbatim messages for the companion offer and the user review gate, and a concrete 4-step self-review procedure. Minor gaps remain — the "invoke writing-plans skill" step depends on an external skill, and no example shows what a proposed approach or design section looks like.

4 / 5

Workflow Clarity

The 9-item checklist gives a clear ordered sequence, and validation checkpoints with feedback loops are explicit throughout: "get user approval after each section", the self-review fix-inline loop, and the user review gate with a 'changes requested' -> revise cycle — also visualized in the dot graph. This matches anchor 5 (explicit validation steps, feedback loops, checklists).

5 / 5

Progressive Disclosure

The body appropriately defers detail with a clearly signaled one-level reference ("read the detailed guide before proceeding: skills/brainstorming/visual-companion.md"), but that file is not present in the bundle (no references/ or skills/ directory exists), and none of the five scripts/ bundle files (server.cjs, helper.js, start-server.sh, etc.) are referenced or discoverable from the body. Structure is otherwise good, but the dangling reference and unlisted bundle content leave navigation incomplete — anchor 3.

3 / 5

Total

15

/

20

Passed

Description

66%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 phrasing and a clear gating role, but it under-describes what the skill actually does (producing validated designs and specs) and its extremely broad trigger scope creates overlap risk with implementation skills. It is a solid, functional description with room to sharpen the capability statement.

Suggestions

Add 1-2 concrete output capabilities to the 'what' clause, e.g. 'Explores user intent, proposes 2-3 design approaches, and produces a validated design spec' — this would lift specificity and completeness.

Narrow or qualify the trigger scope (e.g. 'before any non-trivial feature work') to reduce conflict risk with implementation skills while keeping the natural trigger phrases.

DimensionReasoningScore

Specificity

The description names the domain and a single concrete action ("Explores user intent, requirements and design before implementation"), but the list "creating features, building components, adding functionality, or modifying behavior" is trigger phrasing rather than capabilities. It matches anchor 3 (1-2 concrete actions, not comprehensive) rather than 4, which expects several distinct listed actions.

3 / 5

Completeness

Both parts are present: an explicit 'when' ("You MUST use this before any creative work - creating features, building components...") with concrete triggers, and a 'what' ("Explores user intent, requirements and design"). Not 5 because the 'what' is a single thin clause — the skill's actual outputs (designs, specs, approach trade-offs) are not described.

4 / 5

Trigger Term Quality

"creating features", "building components", "adding functionality", and "modifying behavior" are phrases users naturally say when requesting this skill. Common variations like "design", "implement", or "new feature" are missing, keeping it at anchor 4 rather than 5.

4 / 5

Distinctiveness Conflict Risk

The skill has a distinct niche (pre-implementation design exploration), but its triggers cover essentially all creative/building work, so it would fire alongside nearly every implementation-related skill. It sits between anchor 2's high overlap and anchor 4's minor overlap.

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