CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

brainstorm

Use when starting a complex feature, exploring unclear requirements, or needing to challenge assumptions before committing to a design - before /plan.

Quality

61%

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 ./skills/brainstorm/SKILL.md
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 strongly sequenced, gate-checked workflow with genuinely actionable question scripts and output templates — workflow clarity is excellent. Its weaknesses are token efficiency (a padded anti-rationalization table and repeated verification content) and the lack of any progressive disclosure: a ~290-line monolith with no reference files.

Suggestions

Move the ideation-frameworks table, anti-rationalization table, and step output templates into one-level-deep reference files (e.g. references/frameworks.md, references/templates.md) linked from the relevant steps, slimming the always-loaded SKILL.md.

Deduplicate the BLOCKED conditions, Verification Protocol, and Rules sections into a single canonical checklist to cut repeated content.

Add one worked mini-example of a completed output (e.g. a filled-in decision matrix for a small feature) so the placeholder-only templates become concrete.

DimensionReasoningScore

Conciseness

The body is mostly dense, structured templates with no concept tutorials, but it includes unnecessary material: the anti-rationalization table ("'I already know the best approach' | You know ONE approach..."), the SCAMPER letter expansion Claude already knows, and a Verification Protocol that restates the per-step BLOCKED conditions ("At least 3 alternatives were generated with pros/cons"). This fits anchor 3 (mostly efficient but could be tightened) rather than 4, where padding would be only minor.

3 / 5

Actionability

Guidance is highly concrete: copy-paste-ready question scripts ("When you say 'fast', what response time is acceptable?"), worked example values ("< 200ms p95 response time", "10k concurrent users", matrix scores "7.05/7.35/6.55"), and explicit integration conditionals ("IF @planner classifies task as COMPLEX"). Not 5 because many output templates remain pure placeholders ([desc], [list]) with no worked end-to-end example and a few directives stay abstract ("Map the domain - Identify entities, relationships, boundaries").

4 / 5

Workflow Clarity

The five-step workflow is clearly sequenced with explicit validation gates at every step ("BLOCKED until problem space is understood", "BLOCKED until at least 5 assumptions are identified and tested", "BLOCKED until 3+ alternatives with pros/cons exist"), user feedback loops ("Section 1: Problem & scope (approve?)"), and a closing Verification Protocol checklist. Checkpoints are explicit at every step with feedback loops and a checklist, matching anchor 5 rather than 4.

5 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are absent), so everything is inline in a ~290-line single file. Sections are well-organized with clear per-step headers, but large step-specific lookup material (the ideation-frameworks table, anti-rationalization table, and output templates) is inlined rather than split into one-level-deep reference files. This fits anchor 3 (some structure, could be better organized) rather than 4, since a body well over 50 lines keeps all reference-worthy content inline.

3 / 5

Total

15

/

20

Passed

Description

36%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 is a trigger-only statement: it gives several concrete 'use when' scenarios but never says what the skill actually does, and it omits the most natural keyword ("brainstorm"). It also carries real routing overlap with planning/discovery skills it explicitly integrates with.

Suggestions

Lead with a capability statement before the trigger clause, e.g. "Refine ideas through Socratic questioning: clarify vague terms, test assumptions, and compare 3+ design alternatives. Use when..." so the description answers both 'what' and 'when'.

Add the natural trigger word "brainstorm" itself plus common synonyms like "explore options", "weigh alternatives", or "spike on a design".

Sharpen differentiation from adjacent skills in the description itself, e.g. "use before /plan for design-space exploration; skip for tasks with clear specs", to reduce conflict with planning/discovery skills.

DimensionReasoningScore

Specificity

The description never states what the skill does — phrases like "starting a complex feature", "exploring unclear requirements", and "needing to challenge assumptions" are user trigger scenarios, not skill capabilities. It names the brainstorming/design domain with several specific trigger phrases, fitting anchor 2 rather than 3 (no concrete skill actions listed) or 1 (not pure abstraction).

2 / 5

Completeness

Only the 'when' is present without any 'what' — the description never says the skill refines ideas through questioning, tests assumptions, or generates alternatives. This matches anchor 2 ("only 'when' is present without 'what'") exactly; not 3 because no capability statement exists, not 1 because the 'when' clause is concrete and multi-triggered rather than extremely vague.

2 / 5

Trigger Term Quality

Relevant keywords are present ("complex feature", "unclear requirements", "challenge assumptions", "before /plan") but the most natural term a user would say — "brainstorm" itself — plus synonyms like "explore options" or "weigh alternatives" are missing. This matches anchor 3 (some relevant keywords, missing common variations) rather than 4 (good coverage with only a few gaps).

3 / 5

Distinctiveness Conflict Risk

The "before /plan" qualifier positions the skill, but triggers like "starting a complex feature" and "exploring unclear requirements" would plausibly also fire a planning or discovery skill — the body itself integrates with @planner and /discovery. Somewhat specific with real overlap risk against closely related skills, fitting anchor 3 rather than 4.

3 / 5

Total

10

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

14

/

16

Passed

Repository

fernandezbaptiste/specialist-agent

Path

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