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 research-validated prompt patterns.

60

Quality

70%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./plugins/brainstorming-skill/skills/brainstorming-skill/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

73%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The content delivers a clear, gated workflow with genuine feedback loops and concrete output specifications, supported by a well-signaled reference layer. Its weaknesses are systematic duplication of the same workflow three times over and navigation gaps: a large fraction of the bundle is orphaned and the central 'Pattern Library' is never linked.

Suggestions

State the workflow once (the Mermaid diagram) and cut the duplicated numbered list and the repeated 'authoritative procedure' boilerplate from the [!IMPORTANT] block.

Link 'Pattern Library' to its actual home file (e.g., comprehensive-prompt-library-ready-to-use-templates.md) or consolidate it under the Pattern Documentation References section.

Either link or remove the 12 orphaned reference files (better-creator.md, clickup-templates.md, itonics-innovation-platform.md, etc.) so every bundle file is discoverable from SKILL.md.

DimensionReasoningScore

Conciseness

The body is mostly efficient but systematically duplicated: the six-step workflow appears as a numbered list, again in the [!IMPORTANT] Process Flow block, and a third time as Mermaid nodes; the 'authoritative procedure / execute steps in the exact order shown' boilerplate is repeated verbatim before both diagrams. Not 2 because there is no padding that explains concepts Claude already knows; not 4 because the triple restatement is structural, not a minor trim.

3 / 5

Actionability

Guidance is concrete and executable: exact output path ('docs/plans/YYYY-MM-DD-<topic>-design.md'), specific output-format specs ('Table format: Idea | Reasoning | Implementation | Trade-offs', word count ranges), and a labeled decision diagram. Minor gaps: 'Pattern Library' is invoked twice but never linked to a file, and no example prompt template is shown inline.

4 / 5

Workflow Clarity

The sequence is clear with explicit validation gates (user approval after each design section), an explicit revision feedback loop ('User requests revision -- revise and re-present' loops back to Present), and an ambiguity-pause rule before continuing. This matches the anchor-5 pattern of sequenced steps with feedback loops for error recovery.

5 / 5

Progressive Disclosure

SKILL.md is a proper overview with seven one-level-deep reference links, each with a one-line description, and all seven linked files exist in references/. Held below 5 because 12 of the 19 bundle files (e.g., learn-prompting.md, machine-learning-mastery.md, clickup-templates.md) are orphans unreachable from SKILL.md, and the 'Pattern Library' the body depends on has no linked home. Not 3 because the linked references are clearly signaled and content is appropriately split.

4 / 5

Total

16

/

20

Passed

Description

66%Weight 40%Scale 1-5

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 answers both 'what' and 'when' explicitly with concrete trigger phrases, but it is written in second person (penalized), its capability description is abstract, and its trigger scope is so broad that it would conflict with nearly every feature-development workflow.

Suggestions

Rewrite in third person ('Guides collaborative brainstorming...') instead of 'You MUST use this' to avoid the specificity penalty.

Narrow the trigger scope from 'any creative work' to a bounded niche (e.g., pre-implementation design and ideation) and drop generic triggers like 'adding functionality'/'modifying behavior' that overlap with planning and implementation skills.

Add the natural synonyms users actually say ('brainstorm', 'come up with ideas', 'design', 'spec') to improve trigger-term coverage.

DimensionReasoningScore

Specificity

The description names the domain and 1-2 abstract actions ('Explores user intent, requirements, and design before implementation'), matching anchor 3, but the second-person voice ('You MUST use this') triggers the rubric's -1 specificity penalty, landing it at 2. It is not 1 because concrete capability areas (features, components, behavior) and the core action are explicitly named.

2 / 5

Completeness

Both questions are explicitly answered: what ('Explores user intent, requirements, and design before implementation using research-validated prompt patterns') and when ('before any creative work... or when users request help with ideation, marketing, and strategic planning') with concrete trigger phrases. This matches the anchor-5 example structure exactly.

5 / 5

Trigger Term Quality

Good coverage of natural trigger phrases users would say ('creating features', 'building components', 'adding functionality', 'modifying behavior', 'marketing', 'strategic planning'), but common synonyms like 'brainstorm', 'design', or 'ideas' are missing. Not 3 because coverage is broad and natural rather than partial; not 5 because key conversational variants are absent.

4 / 5

Distinctiveness Conflict Risk

'Before any creative work' plus 'creating features', 'adding functionality', and 'modifying behavior' would fire on virtually every development task, creating high overlap risk with planning, design, and implementation skills. It is not 3 because the trigger scope is 'ANY creative work' rather than a bounded niche; it is not 1 because the ideation/brainstorming domain does give it some identity.

2 / 5

Total

13

/

20

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 — 16 / 16 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.