brainstorming

Creative exploration and brainstorming; use it when you need to clarify goals/constraints, explore multiple options, and converge on a direction before implementation.

Quality

74%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./scientific-skills/Other/brainstorming/SKILL.md

Quality

Content

75%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 is well-structured, lean, and actionable with a concrete output template and a clearly sequenced workflow backed by a genuine reference file. Main weaknesses are mild content redundancy and validation/alignment checkpoints deferred to the reference rather than surfaced in the body.

Suggestions

Collapse the redundant workflow restatements across Key Features, the example template, and Implementation Details into a single canonical sequence.

Surface the alignment/confirmation checkpoint ("confirm correct understanding after each output") from the reference into the body's workflow so feedback loops are visible inline.

Trim the placeholder "..." lines in the output template or replace them with one fully worked example to lift actionability.

Dimension	Reasoning	Score
Conciseness	The body is lean and avoids explaining concepts Claude already knows, though Key Features, the example template, and Implementation Details restate the same workflow with some redundancy.	4 / 5
Actionability	A concrete runnable output template with a filled comparison table and explicit parameters to capture gives actionable guidance, though placeholder fields ("...") keep it from being fully copy-paste ready.	4 / 5
Workflow Clarity	A clear five-step sequence (Clarify, Diverge, Decompose, Evaluate, Converge) is present; as a non-destructive skill no validation cap applies, but explicit alignment checkpoints live only in the reference, not the body.	4 / 5
Progressive Disclosure	SKILL.md is an overview pointing to one real one-level-deep reference (references/brainstorming-workflow.md), but the workflow content is partly duplicated between the body and that reference.	4 / 5
	Total	16 / 20 Passed

Description

73%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 clearly answers both what and when with a strong explicit trigger clause, but its actions are abstract and the second-person phrasing costs specificity. It is a solid, distinct trigger for a conceptual skill.

Suggestions

Rewrite in third person to avoid the second-person "you" (e.g., "Use when clarifying goals..." instead of "use it when you need to clarify...").

Add one or two more concrete, recognizable trigger synonyms (e.g., "ideation", "decision-making", "exploring trade-offs") to broaden natural keyword coverage.

Dimension	Reasoning	Score
Specificity	Names the brainstorming domain and three actions (clarify, explore, converge) but they are abstract rather than concrete; base 3 reduced by 1 because the description uses second person ("you need to").	2 / 5
Completeness	Clearly states what it does ("Creative exploration and brainstorming") and explicitly when to use it with concrete trigger phrases via "use it when you need to...".	5 / 5
Trigger Term Quality	Natural terms like "brainstorming", "clarify goals", "explore options", and "converge on a direction" appear with an explicit "use it when" trigger, though a few synonyms are missing.	4 / 5
Distinctiveness Conflict Risk	"brainstorming" is a recognizable niche with distinct triggers, though it could overlap with general planning or decision-making skills.	4 / 5
	Total	15 / 20 Passed

Validation

93%

Warnings & errors only

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

Criteria	Description	Result
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	15 / 16 Passed

Repository: aipoch/medical-research-skills
Path: scientific-skills/Other/brainstorming/SKILL.md
Commit: f5ef65b

Reviewed: ~13 hours ago

Table of Contents

Discovery Implementation Validation

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.