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
61%
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 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.
| 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 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.
| 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 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.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
b9f32ec
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.