CtrlK
BlogDocsLog inGet started
Tessl Logo

trellis-brainstorm

Guides collaborative requirements discovery before implementation. Creates task directory, seeds PRD, asks high-value questions one at a time, researches technical choices, and converges on MVP scope. Use when requirements are unclear, there are multiple valid approaches, or the user describes a new feature or complex task.

68

Quality

86%

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 trellis-brainstorm in mindfold-ai/Trellis

SKILL.md
Quality
Evals
Security

Quality

Content

77%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 a well-sequenced, highly actionable planning workflow with explicit gates, checklists, and feedback loops — its strongest qualities. It is weakened by token inefficiency: a generic first-principles thinking framework Claude already knows, and the approval-gate rule repeated across five sections. At 200 lines with zero bundle files, it also misses the opportunity to split detailed material (artifact rules, convergence pass) into reference files.

Suggestions

Trim or relocate the 'Thinking Framework: First Principles Analysis' section (~35 lines) — it restates generic methodology Claude already knows; if kept, move it to a reference file and keep a one-line pointer in SKILL.md.

State the implementation-approval rule once in the Planning Contract and reference it from the Planning Flow, Question Rules, and Quality Bar instead of restating it five times.

Move the detailed Artifact Rules and PRD Convergence Pass sections into reference files (e.g., references/artifacts.md), keeping SKILL.md as a lean overview with well-signaled one-level-deep references.

DimensionReasoningScore

Conciseness

Most of the body is non-obvious, project-specific process rules (Trellis gates, artifact schemas, task.py contract), but the 35-line "Thinking Framework: First Principles Analysis" section teaches generic methodology Claude already knows ("Network latency ≥ 0, disk I/O has limits"), and the implementation-approval rule is restated in at least five places (Planning Contract, Planning Flow steps 8–9, Question Rules, Quality Bar, closing line). Fits anchor 3: mostly efficient but includes unnecessary explanation and could be tightened; not 2 because the majority of the content earns its tokens, not 4 because the First Principles section and repetition are clearly trimmable.

3 / 5

Actionability

The skill provides a copy-paste-ready command ("TASK_DIR=$(python3 ./.trellis/scripts/task.py create \"<short task title>\" --description \"<one-line summary>\" --slug <slug>)") plus concrete, checkable guidance throughout: the 6-item Question Rules format, the Requirement Convergence Gate checklist, per-artifact content lists, and the Quality Bar checklist. Per the scoring notes, instruction-only skills are judged on concrete specific guidance, which this fully delivers; minor gap-free coverage of the common cases supports 5 over 4.

5 / 5

Workflow Clarity

The 9-step numbered Planning Flow is clearly sequenced with explicit validation checkpoints: the requirement convergence gate, the PRD convergence pass ("read prd.md top to bottom and verify that no fact is repeated"), and the approval gate. Feedback loops are explicit — "After each user answer, update prd.md, recompute the decision inventory, and repeat from step 2" and "If the artifacts change materially after approval, repeat the final review". This matches anchor 5; anchor 4 is ruled out because checkpoints are named gates with checklists, not merely present.

5 / 5

Progressive Disclosure

The skill is a monolithic 200-line file with no references/, scripts/, or assets/ directories and no external file references at all. Section headers provide decent navigation, but generic content that clearly belongs in a separate reference (the First Principles framework) and substantial artifact/procedure detail are fully inlined. Fits anchor 3 (some structure, content that should be separate is inline) rather than 2 because headers and gates organize the body well, and not 4–5 because nothing is split out despite the length.

3 / 5

Total

16

/

20

Passed

Description

88%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: third-person voice, concrete multi-action capability statement, and an explicit 'Use when...' trigger clause covering the main invocation scenarios. The only weaknesses are a slightly broad trigger ("new feature or complex task") creating some overlap risk with general planning skills, and a few missing natural synonyms such as "brainstorm" or "plan".

DimensionReasoningScore

Specificity

The description lists five concrete, distinct actions: "Creates task directory, seeds PRD, asks high-value questions one at a time, researches technical choices, and converges on MVP scope" — comprehensive coverage of the skill's workflow. Anchor 4 is ruled out because there are no minor gaps; the action list spans the full discovery-to-convergence process.

5 / 5

Completeness

Both halves are explicit and concrete: the "what" is the action list (create task directory, seed PRD, ask questions, research, converge on MVP scope) and the "when" is "Use when requirements are unclear, there are multiple valid approaches, or the user describes a new feature or complex task". This matches the anchor-5 example pattern exactly; anchor 4 is ruled out because the 'when' clause is explicit rather than merely present.

5 / 5

Trigger Term Quality

"requirements are unclear", "multiple valid approaches", "user describes a new feature or complex task" are natural phrases, but common variations like "brainstorm", "plan/plan a feature", or "spec" are absent. Fits anchor 4 (good keyword coverage, a few natural terms missing) rather than 5, which requires comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

"Guides collaborative requirements discovery before implementation" with PRD/task-directory artifacts carves out a distinct planning niche, but the trigger "user describes a new feature or complex task" is broad and could overlap with general planning or scaffolding skills. Minor overlap risk with closely related skills fits anchor 4, not 5.

4 / 5

Total

18

/

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
mindfold-ai/Trellis
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.