CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

brainstorming

Use when starting any creative work — creating features, building components, adding functionality, or modifying behavior — before writing any implementation code.

Quality

65%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

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

Quality

Content

70%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-engineered process skill: the workflow is unambiguous, gated, and self-correcting, with concrete phrasings and paths that make it directly executable. Its weaknesses are redundancy (the gate rule restated four ways plus a diagram that duplicates the checklist) and a broken bundle layout — referenced guide files are missing and the provided scripts are unreachable from the body.

Suggestions

Fix the bundle wiring: either include `visual-companion.md` and `spec-document-reviewer-prompt.md` in the bundle and correct their paths, or point the body's references at the actual `scripts/` files (e.g., "run `scripts/start-server.sh` — see scripts/ for the companion implementation").

Cut one of the four restatements of the no-implementation gate (the graphviz diagram is the most redundant with the checklist, at ~30 lines) and trim the modularity rationale in "Design for isolation and clarity" to the decision rule only.

Consolidate the Rationalization Table and Red Flags sections, which cover substantially the same failure modes.

DimensionReasoningScore

Conciseness

The body is mostly tight process guidance, but the no-implementation gate is restated four ways (HARD-GATE block, checklist, Rationalization Table, Red Flags), the 30-line graphviz diagram duplicates the 9-item checklist, and the "Design for isolation and clarity" section explains modularity benefits Claude already knows. This is anchor 3 — some unnecessary explanation that could be tightened — rather than anchor 4, where over-explanation is only minor.

3 / 5

Actionability

For an instruction-only skill the guidance is highly concrete: exact spec paths (`docs/rubypowers/specs/` with legacy `docs/superpowers/specs/` handling), the filename format `YYYY-MM-DD-<topic>-design.md`, verbatim user-facing messages, a batching rule (up to 4 independent multiple-choice questions), and a 4-point self-review checklist. It falls to anchor 4 rather than 5 because two steps reference files (`spec-document-reviewer-prompt.md`, `skills/brainstorming/visual-companion.md`) that are not present in the bundle, making them non-executable as written.

4 / 5

Workflow Clarity

The process is fully sequenced with explicit validation checkpoints and feedback loops: an ordered 9-item mandatory checklist, per-section design approval, a spec self-review with fix-inline loop, a user review gate with "Wait for the user's response" and re-run on changes, decision diamonds in the flow graph ("no, revise", "changes requested"), and a Red Flags section that routes back to the checklist. This matches anchor 5 (clear sequence, explicit validation, feedback loops, checklist); no destructive/batch cap applies.

5 / 5

Progressive Disclosure

Scored against the actual bundle: the body's only two file references (`skills/brainstorming/visual-companion.md` and `spec-document-reviewer-prompt.md`, described as "same directory as this skill") do not exist in the bundle, while the five scripts/ files that are provided (server.cjs, helper.js, frame-template.html, start/stop-server.sh — the visual companion implementation) are never mentioned in the body. Structure and signaling within SKILL.md are decent, matching anchor 3, but broken reference paths and undiscoverable scripts keep it below anchor 4's "minor organization gaps".

3 / 5

Total

15

/

20

Passed

Description

43%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 has a strong, explicit "Use when..." trigger clause with natural phrasing, but it is one-sided: it says nothing about what the skill does, so a model matching on capabilities has nothing to match. Adding a short capability statement (e.g., turning ideas into approved design specs through one-question-at-a-time dialogue) would fix both the completeness and specificity gaps.

Suggestions

Add a capability clause before the trigger, e.g., "Turns ideas into approved design specs through collaborative questioning — explore context, ask clarifying questions, propose 2-3 approaches, and write a committed spec. Use when starting any creative work..."

Include the skill's terminal output in the description ("...then hands off to the writing-plans skill") so it is distinguishable from general design/brainstorm skills and from implementation skills.

Add common user phrasings as triggers — "design a feature", "new project", "scaffold" — to round out the trigger synonyms.

DimensionReasoningScore

Specificity

The only concrete phrases — "creating features, building components, adding functionality, or modifying behavior" — describe the user's work, not the skill's own capabilities; what the skill actually does (collaborative design dialogue, spec writing, handoff to planning) is never stated. This matches anchor 2 (domain named, skill's actions absent) rather than anchor 3, which requires 1-2 concrete actions of the skill itself.

2 / 5

Completeness

"Use when starting any creative work... before writing any implementation code" answers "when" explicitly and well, but the "what" is entirely missing — the description never says the skill turns ideas into designs and specs. This is precisely anchor 2's "only 'when' is present without 'what'"; anchor 3 requires a clear "what".

2 / 5

Trigger Term Quality

Natural trigger phrases like "creating features", "building components", "adding functionality", "modifying behavior", and "before writing any implementation code" give good verb-level coverage. It falls short of anchor 5 because common phrasings such as "design", "new feature", or "scaffolding a project" are missing.

4 / 5

Distinctiveness Conflict Risk

"before writing any implementation code" carves a distinct pre-implementation niche, but "starting any creative work" is broad enough to fire on nearly every feature request, creating overlap risk with implementation and design skills. Anchor 3 (somewhat specific, still overlaps with similar skills) is the best fit — not 4, since the overlap risk extends beyond closely related skills.

3 / 5

Total

11

/

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

lucianghinda/superpowers-ruby

Path

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.