CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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

77%

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 ./scientific-skills/Other/brainstorming/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

67%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.

A well-structured, actionable skill body with a clear five-phase workflow, a concrete runnable output template, and a genuine one-level-deep reference file. Main weaknesses are duplication between 'Key Features' and 'Implementation Details' and missing explicit alignment checkpoints in the body itself.

Suggestions

Merge the 'Key Features' list into 'Implementation Details' (or replace its bullets with a pointer to the workflow) to remove the duplicated five-phase content and tighten token usage.

Add an explicit alignment checkpoint to the body's workflow (e.g., 'After each phase, confirm understanding with the user before proceeding'), mirroring step 4 of the referenced workflow.

Format the reference as a clear markdown link (e.g., [brainstorming-workflow.md](references/brainstorming-workflow.md)) and drop the near-empty 'Dependencies: None' section.

DimensionReasoningScore

Conciseness

The body is mostly efficient — structured lists, no explanations of concepts Claude already knows — but the 'Key Features' section substantially duplicates the five-phase workflow restated in 'Implementation Details', and a 'Dependencies: None' section adds little. This fits 'mostly efficient but includes some unnecessary explanation or could be tightened' better than the minor-trim-only 4 anchor.

3 / 5

Actionability

Concrete guidance includes a worked example prompt, a near-copy-paste output template (numbered sections, comparison table with concrete options like 'Daily micro-challenges'), and a numbered core-parameters checklist. For an instruction-only skill this is mostly executable guidance, but the template's '...' placeholders keep it just short of fully copy-paste ready, so 4 rather than 5.

4 / 5

Workflow Clarity

The workflow is a clear five-step sequence (Clarify → Diverge → Decompose → Evaluate → Converge) with a defined output structure, matching the 4 anchor 'clear sequence with most checkpoints present; minor validation gaps'. It is not a 5 because the body itself lacks explicit validation/alignment checkpoints — those appear only in the referenced workflow file — though as a non-destructive ideation skill the missing-validation cap does not apply.

4 / 5

Progressive Disclosure

The body is an overview with a real, one-level-deep reference (references/brainstorming-workflow.md exists and is flagged in both 'Key Features' and 'Implementation Details'), organized into clearly headed sections. It falls short of the 5 anchor because the reference is cited as a plain path rather than a well-signaled link, and a fair amount of workflow detail is inlined in the body that duplicates the reference file.

4 / 5

Total

15

/

20

Passed

Description

78%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.

A strong description with an explicit 'use when' trigger clause, three concrete process actions, and good natural keyword coverage. Its main deductions are the second-person voice ('use it when you need to') and some missing synonyms like 'ideation' or 'compare trade-offs'.

Suggestions

Rewrite in third-person voice (e.g., 'Guides creative exploration and brainstorming; use when the user needs to clarify goals/constraints...') to avoid the second-person specificity penalty.

Add common trigger synonyms such as 'ideation', 'idea generation', or 'compare options and trade-offs' to broaden natural keyword coverage.

DimensionReasoningScore

Specificity

The description names the domain ('Creative exploration and brainstorming') and three process actions ('clarify goals/constraints, explore multiple options, and converge on a direction'), matching the several-actions anchor at 4 — but the second-person phrasing 'use it when you need to...' triggers the rubric's mandated 1-point specificity penalty, bringing it to 3.

3 / 5

Completeness

It explicitly answers both parts: the 'what' is 'Creative exploration and brainstorming' with three concrete actions, and the 'when' is an explicit trigger clause ('use it when you need to clarify goals/constraints, explore multiple options, and converge on a direction before implementation') with concrete trigger phrases. It clearly matches the 5 anchor rather than 4, where the 'when' would be less explicit.

5 / 5

Trigger Term Quality

'brainstorming', 'clarify goals/constraints', 'explore multiple options', and 'converge on a direction' are natural phrases users would say, giving good keyword coverage; common variations like 'ideation', 'idea generation', and 'compare trade-offs' are missing, which fits the 'good coverage, a few natural terms missing' anchor rather than the comprehensive 5.

4 / 5

Distinctiveness Conflict Risk

'brainstorming' is a fairly distinct niche with clear pre-implementation ideation triggers, but 'clarify goals/constraints' overlaps with planning/architecture skills, matching 'mostly distinct; minor overlap risk with closely related skills' rather than the minimal-conflict 5 anchor.

4 / 5

Total

16

/

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

aipoch/medical-research-skills

Path

scientific-skills/Other/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.