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.

66

Quality

78%

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

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

SKILL.md
Quality
Evals
Security

Quality

Content

73%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 process skill with a clear sequenced workflow, explicit approval checkpoints, and a feedback loop. Its main weakness is redundant repetition of the gating injunction across multiple sections, which inflates token cost without adding clarity.

Suggestions

Consolidate the gating injunction: state the HARD-GATE once and reference it from the Anti-Pattern, terminal-state, and After-the-Design sections instead of restating 'do NOT invoke any other skill' four times.

Add a short example design-doc skeleton or a sample Q&A exchange so the expected output shape is concrete and copy-pasteable.

Reconcile the Checklist, Process Flow graph, and 'The Process' section so each step appears authoritatively in one place, reducing overlap.

DimensionReasoningScore

Conciseness

Mostly efficient and free of concept-over-explanation, but the same gating injunction is repeated across the HARD-GATE box, the Anti-Pattern section, the terminal-state warning, and the After-the-Design section, and the Process Flow graph restates the Checklist. This redundancy could be tightened. Not a 4 because the repetition is noticeable rather than minor.

3 / 5

Actionability

Provides concrete, specific guidance for a process skill: a numbered checklist, 'one question at a time', 'prefer multiple choice', 'Propose 2-3 approaches', a concrete doc path 'docs/plans/YYYY-MM-DD-<topic>-design.md', and section scaling ('up to 200-300 words'). Not a 5 because there is no example design-doc output or sample dialogue showing the expected result.

4 / 5

Workflow Clarity

Clear sequenced checklist (1-6), a process-flow diagram with an explicit 'User approves design?' checkpoint and a 'no, revise' feedback loop, plus incremental per-section approval gates. This is not a destructive/batch operation, so the validation cap does not apply; the multi-step process with feedback loops matches the top anchor.

5 / 5

Progressive Disclosure

Well-organized into clear sections (Overview, Checklist, Process Flow, The Process, After the Design, Key Principles) in a single file with no bundle files needed for this process skill. Not a 5 because the Checklist, Process Flow graph, and The Process section overlap in content, a minor organization gap; no external references are used or signaled.

4 / 5

Total

16

/

20

Passed

Description

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

A strong description that explicitly covers both what the skill does and when to use it, with concrete trigger phrases and a clear pre-implementation-gate niche. It could be sharpened by adding design-process synonyms and more concrete deliverable verbs.

DimensionReasoningScore

Specificity

Names the creative-work domain and lists several concrete trigger actions ('creating features, building components, adding functionality, or modifying behavior') alongside the core action ('Explores user intent, requirements and design'), with only minor gaps in coverage. Not a 5 because the core action 'explores...design' is somewhat abstract compared to concrete deliverable verbs.

4 / 5

Completeness

Explicitly answers both 'what' ('Explores user intent, requirements and design before implementation') and 'when' ('You MUST use this before any creative work - creating features, building components, adding functionality, or modifying behavior') with concrete trigger phrases. The 'Use when...' equivalent trigger guidance is explicit, so the completeness cap of 3 does not apply.

5 / 5

Trigger Term Quality

Includes natural phrases users would say ('creating features', 'building components', 'adding functionality', 'modifying behavior') with good coverage. Not a 5 because common synonyms like 'brainstorm', 'design', or 'plan' are missing, and there are no file-extension or artifact triggers relevant to this domain.

4 / 5

Distinctiveness Conflict Risk

Positioned as a distinct pre-implementation gate ('before any creative work', 'before implementation'), which gives it a clear niche and mostly-distinct trigger framing. Not a 5 because 'creative work', 'adding functionality', and 'modifying behavior' are broad and overlap with many implementation skills, creating minor conflict risk.

4 / 5

Total

17

/

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
foryourhealth111-pixel/Vibe-Skills
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.