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.

72

Quality

64%

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 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.'

DimensionReasoningScore

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.

DimensionReasoningScore

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.

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.