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.
72
64%
Does it follow best practices?
Impact
Pending
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 cover both 'what' and 'when' but is undermined by its extreme breadth, claiming applicability to nearly all creative and development tasks. The mandatory tone ('You MUST use this') and overly broad scope make it likely to conflict with many other skills. The actual capability—exploring intent and requirements using prompt patterns—is somewhat vague about concrete outputs.
Suggestions
Narrow the scope significantly: instead of 'any creative work,' specify the exact types of tasks where this pre-implementation exploration is most valuable, to reduce conflict with other skills.
Add concrete output descriptions: specify what the skill produces (e.g., 'Generates structured requirements documents, user stories, design specifications') rather than the vague 'explores user intent, requirements, and design.'
Replace the imperative 'You MUST use this' with third-person descriptive voice (e.g., 'Facilitates requirements gathering and design exploration before implementation') and use more natural trigger terms users would actually say, like 'plan,' 'brainstorm,' 'scope,' or 'requirements.'
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | It names some actions ('creating features, building components, adding functionality, modifying behavior, ideation, marketing, strategic planning') and mentions '30+ research-validated prompt patterns,' but the core capability—'Explores user intent, requirements, and design before implementation'—is somewhat vague about what concrete outputs or actions the skill produces. | 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, adding functionality, modifying behavior, ideation, marketing, strategic planning). The 'Use when' equivalent is clearly stated upfront. | 3 / 3 |
Trigger Term Quality | Includes some natural terms like 'creating features,' 'building components,' 'ideation,' 'marketing,' and 'strategic planning,' but these are extremely broad and not distinctive trigger terms. Missing more specific natural phrases users would say like 'brainstorm,' 'requirements gathering,' 'design review,' or 'planning session.' | 2 / 3 |
Distinctiveness Conflict Risk | The description is extremely broad—'before any creative work' and listing nearly every type of development or strategic task means this skill would trigger for a huge range of requests, creating high conflict risk with virtually any coding, design, planning, or creative skill. | 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 skill excels at workflow structure and progressive disclosure—the phased process with explicit approval gates and Mermaid diagrams is well-designed, and reference files are cleanly organized. However, it loses points on conciseness due to repeated meta-instructions about Mermaid diagrams and some filler content, and on actionability because the main file lacks any concrete examples of brainstorming outputs, clarifying question sequences, or pattern applications, deferring everything to reference files.
Suggestions
Add 1-2 concrete examples inline showing what a brainstorming interaction looks like (e.g., a sample clarifying question sequence or a sample '2-3 approaches with trade-offs' output) to improve actionability.
Remove the duplicated Mermaid interpretation instructions (the two paragraphs in the IMPORTANT callout)—state it once briefly or not at all, since Claude understands Mermaid diagrams.
Trim the format_guidance section or move it to a reference file—tips like 'numbered list > bullet points' and '40% quality increase' are generic prompting advice that don't add skill-specific value.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill has some unnecessary verbosity—the repeated Mermaid diagram instructions ('treat it as the authoritative procedure...'), the format_guidance section explaining general prompting tips, and the category index listing 14 categories by name without actionable detail all consume tokens without adding proportional value. However, the core workflow and references are reasonably efficient. | 2 / 3 |
Actionability | The workflow steps are clearly listed and the Mermaid diagrams provide concrete sequencing, but the actual pattern content is deferred entirely to reference files. The 14 categories are listed as names only with no executable examples or templates inline. The skill tells Claude what to do at a process level but lacks concrete examples of what a brainstorming output or clarifying question sequence looks like. | 2 / 3 |
Workflow Clarity | The workflow is clearly sequenced with explicit phases (Discovery → Validation → Completion), includes a validation checkpoint with an approval gate and revision loop, and has a hard gate preventing premature implementation. The Mermaid diagram makes the flow unambiguous with decision points and feedback loops. | 3 / 3 |
Progressive Disclosure | The skill provides a clear overview with well-organized sections and delegates detailed pattern documentation to 7 clearly labeled reference files, all one level deep. The category index serves as a navigational aid without bloating the main file. | 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.
11ec483
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.