CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

he-brainstorm

Explore Harness Engineering options, filter ornate or weak ideas, recover dropped leverage, and select survivor routes before commitment. Use when intent, stage choice, tradeoffs, idea quality, or possible solution shapes are still unsettled before spec, plan, Linear, or implementation work.

Quality

72%

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 ./Plugins/harness-engineering/skills/he-brainstorm/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

56%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 a well-sequenced, validation-conscious process with explicit failure handling and concrete artifact routes, but it is held back by named-but-undefined contracts that force reference chasing for core behaviors, structural redundancy across Outputs/Gotchas/Anti-Patterns/Constraints sections, and a reference topology with multi-level chains, out-of-bundle targets, and duplicated content in the hot-path reference.

Suggestions

Add a one-line inline definition for each named contract (BLUF review contract, first-principles contract, stage arc boundary, ubiquitous-language contract) so core behaviors are executable without first reading external files.

Merge the redundant "Outputs"/"Output Format" and "Gotchas"/"Anti-Patterns"/"Constraints" sections into single canonical sections to reclaim tokens.

Flatten the reference topology: consolidate the chained `Infrastructure/references/...` and `../../references/...` hops into a one-level-deep, in-bundle structure, and remove the body-content duplication in `references/hot-path-folded-context.md`.

DimensionReasoningScore

Conciseness

The body is dense policy rather than padded explanation, but there is structural redundancy: "Outputs" and "Output Format" list overlapping field sets, and "Gotchas", "Anti-Patterns", and "Constraints" restate the same guardrails three different ways. It fits anchor 3 (mostly efficient but could be tightened) rather than 4, because the duplication is structural across sections, not minor trims.

3 / 5

Actionability

Concrete anchors exist — artifact routes (`.harness/brainstorm/**.md`), the validation command (`python3 Plugins/harness-engineering/scripts/check_bluf_structure.py ... --json`), and explicit output field names — but core behaviors are invoked by name only ("apply the BLUF review contract", "apply the first-principles contract", "apply the stage arc boundary") with no inline summary, so execution requires chasing external files. This matches anchor 3 (some concrete guidance but incomplete, missing key details) rather than 4, where gaps would be minor.

3 / 5

Workflow Clarity

A 12-step sequenced procedure, an explicit Validation section with pass/fail/blocked statuses and a runnable script, and Failure Handling with recovery loops ("stop with the blocker and smallest recovery step", "ask once; otherwise set `autonomous_assumption`") give clear checkpoints with feedback loops. It fits anchor 4 rather than 5 because validation is conditional ("non-trivial generated artifacts") and is a separate section rather than an explicit step wired into the numbered sequence.

4 / 5

Progressive Disclosure

References are clearly signaled with "Read when..." conditions, but the actual bundle structure reveals problems: local reference files chain onward to `Infrastructure/references/harness-engineering/he-brainstorm-doctrine.md` (2+ levels of nesting), roughly ten `../../references/*.md` targets sit outside the bundle entirely, and `references/hot-path-folded-context.md` duplicates body content (Procedure, Examples, References). This lands at anchor 3 — better signaled than anchor 2's buried references, but the nested chains and duplication exceed anchor 4's "minor organization gaps".

3 / 5

Total

13

/

20

Passed

Description

76%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 and well-conditioned 'Use when' clause and multiple concrete actions. Its main weaknesses are heavy project-specific jargon ("survivor routes", "dropped leverage") and the absence of the most natural trigger word for a brainstorming skill — "brainstorm" itself — which limits trigger coverage and outside comprehensibility.

Suggestions

Include the natural trigger terms users would actually say — "brainstorm", "help me decide", "weigh options" — alongside the existing jargon.

Soften or briefly gloss insider terms like "recover dropped leverage" and "select survivor routes" so the concrete actions are understandable without Harness Engineering context.

DimensionReasoningScore

Specificity

The description lists four concrete actions ("Explore Harness Engineering options, filter ornate or weak ideas, recover dropped leverage, and select survivor routes before commitment"), but insider jargon such as "recover dropped leverage" and "select survivor routes" leaves minor gaps in how comprehensible the actions are. It exceeds anchor 3 (only 1-2 actions) but falls short of anchor 5 because the actions are not fully self-explanatory without domain context.

4 / 5

Completeness

It explicitly answers both what ("Explore... options, filter ornate or weak ideas, recover dropped leverage, and select survivor routes") and when ("Use when intent, stage choice, tradeoffs, idea quality, or possible solution shapes are still unsettled before spec, plan, Linear, or implementation work") with concrete trigger conditions. This matches anchor 5 exactly; the 'when' clause is explicit, not merely implied, so 4 does not fit.

5 / 5

Trigger Term Quality

Natural terms like "options", "ideas", "tradeoffs", "spec", "plan", and "intent" are present, but the single most natural user term for a brainstorm skill — "brainstorm" — never appears, nor do common phrasings like "help me decide" or "weigh options". This matches anchor 3 (relevant keywords but missing common variations) rather than 4, since the missing head term is a variation users would actually say.

3 / 5

Distinctiveness Conflict Risk

"Harness Engineering" branding plus the explicit pre-commitment scope ("before spec, plan, Linear, or implementation work") carves a clear niche distinct from downstream stages. It is not 5 because generic words ("options", "tradeoffs", "spec", "plan") and proximity to sibling he-ideate/he-spec skills leave minor overlap risk, but it is well above anchor 3's generic overlap.

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

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Repository

jscraik/Agent-Skills

Path

Plugins/harness-engineering/skills/he-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.