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.

57

Quality

64%

Does it follow best practices?

Impact

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 virtually any creative or development task. While it does answer both 'what' and 'when,' the extreme breadth creates high conflict risk with other skills, and the actual capabilities described remain somewhat vague beyond 'explores user intent, requirements, and design.' The use of 'You MUST' in second person also violates the third-person voice guideline.

Suggestions

Narrow the trigger scope significantly — instead of 'any creative work,' specify the particular scenarios where this pre-implementation exploration is most valuable (e.g., 'Use when requirements are ambiguous or when starting a new project from scratch').

Rewrite in third person voice ('Explores user intent...' not 'You MUST use this...') and remove the imperative 'MUST' framing, which is inappropriate for a description meant to help Claude choose among skills.

Add more specific concrete actions the skill performs (e.g., 'Generates clarifying questions, creates requirement checklists, produces design alternatives') rather than the vague 'explores user intent, requirements, and design.'

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 almost every other skill in a large skill library.

1 / 3

Total

8

/

12

Passed

Implementation

70%

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 brainstorming skill with strong workflow clarity and good progressive disclosure to reference files. Its main weaknesses are moderate redundancy (the workflow is stated three times in different formats) and limited inline actionability—the actual prompt patterns and templates are deferred entirely to reference files, leaving the main skill somewhat abstract. The mermaid diagram interpretation instructions are unnecessary padding that Claude doesn't need.

Suggestions

Remove the generic mermaid diagram interpretation instructions (the two paragraphs in the Process Flow section starting with '> When provided a process map')—Claude already knows how to follow diagrams.

Include 1-2 concrete, complete pattern examples inline (e.g., a full Perspective Multiplication prompt template with expected output) so the skill is actionable without requiring reference file lookups.

Consolidate the workflow description—choose either the numbered list OR the mermaid diagram, not both, to reduce redundancy.

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 questionable value.

2 / 3

Actionability

The workflow steps are clearly sequenced and the hard-gate is concrete, but the actual ideation patterns are only listed as category names without executable examples or templates inline. The skill relies heavily on external reference files for the actual actionable content (prompt templates, pattern details). The output format guidance is helpful but generic.

2 / 3

Workflow Clarity

The multi-step brainstorming workflow is clearly sequenced with explicit validation checkpoints—the mermaid diagram shows a clear approval gate with a revision loop before proceeding to documentation and transition. The hard-gate enforcement and the 'approve or revise' decision point provide strong feedback loops for this type of process.

3 / 3

Progressive Disclosure

The skill provides a clear overview with well-organized sections and references seven specific external files for detailed pattern documentation, all one level deep with descriptive labels. The main SKILL.md appropriately contains the workflow and category index while deferring detailed patterns to reference files. However, no bundle files were provided to verify these references exist.

3 / 3

Total

10

/

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.