CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

brainstorming

Use before creative or constructive work (features, architecture, behavior). Transforms vague ideas into validated designs through disciplined reasoning and collaboration.

1.66x
Quality

72%

Does it follow best practices?

Impact

93%

1.66x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./plugins/AI-Agents-Safe-Coding-Skills/skills/brainstorming/SKILL.md

The canonical home for this skill is brainstorming in sickn33/agentic-awesome-skills

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 body presents an unusually well-gated facilitation workflow: sequenced steps, hard confirmation gates, per-section checkpoints, and an exit-criteria checklist with a refinement loop. Its weaknesses are repetition of the no-implementation rule, a redundant tautological "When to Use" section, a few vague handoff directives, and one unheaded dangling paragraph.

Suggestions

State the no-implementation rule once (e.g., in Operating Mode) and remove the repetitions in Purpose, step notes, and Exit Criteria.

Delete or rewrite the "When to Use" section with concrete triggers (e.g., "use when the user asks to brainstorm, design, or validate an idea before implementation") instead of the tautological "applicable to execute the workflow or actions described in the overview".

Give the `multi-agent-brainstorming` handoff its own section heading (e.g., "## High-Impact Handoff") so it does not dangle after Key Principles, and make the documentation/handoff steps concrete about where to persist the design document.

DimensionReasoningScore

Conciseness

The body is mostly efficient directive bullets with little explanation of things Claude already knows, but the no-implementation rule is stated three separate ways ("You are **not allowed** to implement, code, or modify behavior", "No creative implementation", "**Do NOT proceed to implementation**") and the closing "When to Use" section is tautological filler ("This skill is applicable to execute the workflow or actions described in the overview"). That is more than the 'minor instances' of anchor 4, fitting anchor 3's 'could be tightened'.

3 / 5

Actionability

The guidance is concrete and executable: "Ask **one question per message**", "a concise summary (5–7 bullets)", "sections of **200–300 words max**", "Propose **2–3 viable approaches**", plus exact prompts to deliver verbatim ("“Does this accurately reflect your intent?”"). A few directives remain vague ("Persist the document according to the project's standard workflow", "Isolate work if the workflow supports it"), so it sits at anchor 4 rather than 5.

4 / 5

Workflow Clarity

The seven steps are explicitly sequenced and gated: step 4 is a hard validation gate ("Do NOT proceed until explicit confirmation is given"), step 6 inserts per-section checkpoints ("“Does this look right so far?”"), and the Exit Criteria section is a checklist with an explicit feedback loop ("If any criterion is unmet: Continue refinement"). This matches anchor 5's clear sequence, explicit validation, feedback loops, and checklists; the skill involves no destructive or batch operations that would demand more.

5 / 5

Progressive Disclosure

The skill is a single self-contained file with no bundle directories, and the content is well organized into numbered, clearly headed sections (Purpose, Operating Mode, Process steps 1–7, After the Design, Exit Criteria, Key Principles) that do not need to be split out. It is not anchor 5 because there is no overview-plus-references structure at all and one paragraph — the mandatory handoff to the `multi-agent-brainstorming` skill — dangles after "Key Principles" with no heading of its own, a minor organization gap characteristic of anchor 4.

4 / 5

Total

16

/

20

Passed

Description

58%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 with a clear input-to-output transformation and an explicit timing clause, landing solidly in the upper-middle range. Its main weaknesses are abstract filler ("disciplined reasoning and collaboration") and a broad trigger scope that misses the most natural user term ("brainstorm") and invites overlap with adjacent planning/design skills.

Suggestions

Replace "through disciplined reasoning and collaboration" with the skill's concrete mechanisms, e.g., "asks clarifying questions one at a time, locks shared understanding, explores 2-3 design approaches, and produces a decision log and design document".

Add natural trigger synonyms users would actually say, such as "brainstorm", "flesh out this idea", "design discussion", or "validate a design before building".

Narrow the trigger scope beyond "creative or constructive work" to pre-implementation design work specifically, reducing overlap with planning, architecture, and code-review skills.

DimensionReasoningScore

Specificity

"Transforms vague ideas into validated designs" states one input-to-output action alongside a named domain ("creative or constructive work (features, architecture, behavior)"), but "through disciplined reasoning and collaboration" is abstract filler and no further concrete actions are listed, matching the anchor for domain plus 1-2 actions without comprehensive coverage. It is above anchor 2 because the transformation stated is more concrete than a purely generic action like "Processes PDF files".

3 / 5

Completeness

Both parts are explicitly present: what ("Transforms vague ideas into validated designs") and when ("Use before creative or constructive work (features, architecture, behavior)"). The when-clause is present and reasonably specific but lacks the concrete trigger phrases of anchor 5 (e.g., "when the user wants to brainstorm an idea or validate a design before building it"), so anchor 4 fits best.

4 / 5

Trigger Term Quality

Trigger terms "features", "architecture", and "creative or constructive work" are natural phrases users would say before starting a design discussion, and "before creative or constructive work" doubles as an explicit timing trigger. It falls short of anchor 5's comprehensive synonym coverage (e.g., "brainstorm", "flesh out an idea", "design doc/spec") but exceeds anchor 3's 'missing common variations'.

4 / 5

Distinctiveness Conflict Risk

The scope "creative or constructive work (features, architecture, behavior)" is broad and would overlap with general planning, architecture, and design-review skills, though the pre-implementation framing ("before" such work) gives it a partial niche. This matches 'somewhat specific but could still overlap with similar skills' rather than anchor 4's mostly-distinct profile.

3 / 5

Total

14

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

plugins/AI-Agents-Safe-Coding-Skills/skills/brainstorming/SKILL.md

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.