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
64%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./plugins/brainstorming-skill/skills/brainstorming-skill/SKILL.mdQuality
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.'
| Dimension | Reasoning | Score |
|---|---|---|
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.
| Dimension | Reasoning | Score |
|---|---|---|
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.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
4e61312
Table of Contents
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.