CtrlK
BlogDocsLog inGet started
Tessl Logo

brainstorming-skill

You MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or when users request help with ideation, marketing, and strategic planning. Explores user intent, requirements, and design before implementation using 30+ research-validated prompt patterns.

69

Quality

61%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./plugins/brainstorming-skill/skills/brainstorming-skill/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

59%

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 attempts to be comprehensive about when to use the skill but overreaches dramatically, claiming it 'MUST' be used before essentially any creative or development task. While it does answer both 'what' and 'when,' the extreme breadth creates serious conflict risk with other skills. The use of 'You MUST' in second person and imperative tone also violates the third-person voice guideline.

Suggestions

Narrow the scope significantly — instead of 'any creative work,' specify the particular type of pre-implementation exploration this skill handles (e.g., 'requirements gathering for software features' or 'design exploration for new components').

Replace the second-person imperative 'You MUST use this' with third-person descriptive voice (e.g., 'Guides pre-implementation exploration of user intent and requirements using research-validated prompt patterns').

Add distinct trigger terms that differentiate this from general coding or planning skills, such as specific pattern names or unique methodology references.

DimensionReasoningScore

Specificity

It names some actions ('creating features, building components, adding functionality, modifying behavior') and mentions '30+ research-validated prompt patterns,' but the actual capabilities are vague — 'explores user intent, requirements, and design' doesn't describe concrete actions the skill performs.

2 / 3

Completeness

It explicitly answers both 'what' (explores user intent, requirements, and design before implementation using prompt patterns) and 'when' (before any creative work, creating features, building components, ideation, marketing, strategic planning). The 'Use when' equivalent is clearly stated upfront.

3 / 3

Trigger Term Quality

Includes some natural terms like 'ideation,' 'marketing,' 'strategic planning,' 'creating features,' and 'building components,' but the scope is so broad that these terms overlap with many possible user requests. Missing more specific trigger terms that would help distinguish this skill.

2 / 3

Distinctiveness Conflict Risk

The description is extremely broad — 'before any creative work' and listing features, components, functionality, behavior, ideation, marketing, and strategic planning means this would trigger for nearly any task. It would conflict with virtually every other skill in a large skill library.

1 / 3

Total

8

/

12

Passed

Implementation

62%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is a well-structured process skill with a clear workflow, explicit validation gates, and good use of mermaid diagrams for sequencing. Its main weaknesses are redundancy (the workflow is stated three times in different formats), some unnecessary meta-instructions Claude doesn't need (how to interpret mermaid diagrams), and the pattern categories being listed without enough inline substance to be actionable without the reference files. The hard gate and approval loop are strong safety features.

Suggestions

Remove the generic mermaid interpretation instructions (the two paragraphs starting with '> When provided a process map...') — Claude already knows how to follow diagrams, and this wastes ~100 tokens.

Consolidate the workflow to appear only twice at most: the numbered list for quick scanning and the mermaid diagram for visual reference. Remove the redundant prose description.

Add at least one concrete example of a completed brainstorming output (e.g., a sample design proposal with 2-3 approaches and trade-offs table) so Claude has a clear template to follow without needing to consult reference files.

DimensionReasoningScore

Conciseness

The skill is moderately efficient but includes some redundancy—the workflow is described three times (numbered list, mermaid diagram, and process flow section preamble). The mermaid instruction preamble about how to interpret diagrams is generic knowledge Claude already has. The format guidance section with percentage claims ('increases quality 40%') adds little actionable value.

2 / 3

Actionability

The workflow steps are concrete and the file naming convention (docs/plans/YYYY-MM-DD-<topic>-design.md) is specific, but the 14 pattern categories are only listed as names without executable examples or templates in the main file. The actual prompt templates are deferred to reference files. The output format guidance gives general tips rather than concrete examples of what a brainstorming output should look like.

2 / 3

Workflow Clarity

The multi-step workflow is clearly sequenced with explicit phases (Discovery → Validation → Completion), includes a validation checkpoint (user approval gate with revision loop), and has a hard gate preventing premature implementation. The mermaid diagram reinforces the sequence with clear decision points and feedback loops.

3 / 3

Progressive Disclosure

The skill references 7 separate reference files with clear links and descriptive labels, which is good structure. However, no bundle files were provided, so the references cannot be verified. Additionally, the 14 pattern categories are listed inline as a bare index without enough context to be useful on their own, creating an awkward middle ground—too much to be a clean overview, too little to be actionable without the references.

2 / 3

Total

9

/

12

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.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
Jamie-BitFlight/claude_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.