CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

brainstorm

Turn an idea into a Conventional Docs Decision, then a Plan: classify the request, explore options and risks through dialogue, then commit a numbered Decision that review, prototypes, and acceptance move through. Use PROACTIVELY before any creative work — new features, new subsystems, interface or dependency changes, or any open-ended design question ("what are the options", "how should I approach", "should I use X or Y", "help me decide", "write a decision", "ADR").

Quality

93%

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

The canonical home for this skill is brainstorm in phatblat/dotfiles

SKILL.md
Quality
Evals
Security

Quality

Content

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

As a harness-generated dispatch wrapper, the body is maximally lean and its single instruction is unambiguous and executable, so conciseness and workflow clarity are top marks. Actionability and progressive disclosure settle at 4 because the entire skill is a bare pointer: no orienting overview, and all real guidance depends on an external shared file that is not part of this bundle and could not be verified to exist.

Suggestions

Add one or two lines of orientation (e.g., the workflow stages or the first action to take) so the body is not a bare pointer and progressive disclosure has a clear overview alongside the reference.

Add a brief fallback instruction for when ~/.agents/skills/brainstorm/SKILL.md is not present (e.g., where to find the shared skill or how to proceed), closing the main actionability gap of delegating all substance to an unverifiable external path.

DimensionReasoningScore

Conciseness

The body is two lines — a generator comment and a single dispatch instruction — with zero padding and no explanation of concepts Claude already knows. Every token earns its place, matching the anchor-5 lean example exactly.

5 / 5

Actionability

"Load and follow the shared skill at `~/.agents/skills/brainstorm/SKILL.md`" is a concrete, unambiguous, executable directive with an exact path (anchor 4's "concrete commands with minor gaps"). It is not anchor 5 because no guidance or examples cover the skill's actual task — all substance is delegated to an external file, with no fallback if that path is unavailable.

4 / 5

Workflow Clarity

This is a single-action skill and the action (load and follow a specific shared skill file) is unambiguous, so the simple-skill exception applies and workflow clarity can score 5. No destructive or batch operations are involved, so the validation cap does not apply.

5 / 5

Progressive Disclosure

The body is a single, clearly signaled, one-level-deep reference with nothing inlined that belongs in a separate file — good structure (anchor 4). It falls short of anchor 5 because there is no overview content at all (just a bare pointer), and the referenced path lives outside the skill's own bundle — no references/, scripts/, or assets/ directories exist here and the ~/.agents path is not resolvable in this environment.

4 / 5

Total

18

/

20

Passed

Description

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

An excellent description: it states a multi-step concrete workflow, gives explicit proactive-use guidance with a rich set of quoted natural trigger phrases including the ADR synonym, and anchors itself in a recognizable decision-record niche. The only weakness is that broad triggers like "any open-ended design question" create some overlap risk with general planning/design skills.

DimensionReasoningScore

Specificity

The description enumerates the full pipeline as concrete actions — "classify the request, explore options and risks through dialogue, then commit a numbered Decision" — with the outputs (Decision, then Plan) and downstream stages ("review, prototypes, and acceptance") named. This matches the anchor-5 comprehensive example rather than anchor 4, since the action coverage has no evident gaps.

5 / 5

Completeness

Both questions are answered explicitly: the "what" ("Turn an idea into a Conventional Docs Decision, then a Plan: classify the request, explore options and risks through dialogue, then commit a numbered Decision") and the "when" ("Use PROACTIVELY before any creative work — new features, new subsystems, interface or dependency changes, or any open-ended design question") with concrete trigger phrases. This is an exact anchor-5 match; anchor 4 would require the 'when' to be less explicit.

5 / 5

Trigger Term Quality

It quotes natural phrases users would actually say — "what are the options", "how should I approach", "should I use X or Y", "help me decide", "write a decision" — plus the domain synonym "ADR" and concrete contexts ("new features, new subsystems, interface or dependency changes"). Coverage including synonyms matches anchor 5, not anchor 4 which expects missing natural terms.

5 / 5

Distinctiveness Conflict Risk

The decision-record framing ("Conventional Docs Decision", "numbered Decision", "ADR") carves out a distinct niche, but the catch-all "any open-ended design question" and "how should I approach" could also fire for general planning or architecture-design skills. That is minor overlap with closely related skills (anchor 4), not anchor 5's "minimal conflict risk" — while anchor 3 would understate the clearly differentiated ADR/decision core.

4 / 5

Total

19

/

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

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

15

/

16

Passed

Repository

phatblat/dotfiles

Path

.agents/harness/adapters/antigravity/skills/brainstorm/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.