CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

multi-agent-brainstorming

Simulate a structured peer-review process using multiple specialized agents to validate designs, surface hidden assumptions, and identify failure modes before implementation.

Quality

66%

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 ./plugins/AI-Agents-Safe-Coding-Skills-claude/skills/multi-agent-brainstorming/SKILL.md

The canonical home for this skill is multi-agent-brainstorming in administrakt0r/AI-Agents-Safe-Coding-Skills

SKILL.md
Quality
Evals
Security

Quality

Content

60%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 coherent, well-gated review process with explicit roles, sequencing, and termination criteria — its strongest qualities. It is weakened by redundant restatement sections, missing execution details (only one reviewer prompt, no Decision Log template, undefined 'Understanding Lock'), and small markdown formatting defects.

Suggestions

Provide a concrete prompt template for each reviewer agent (Skeptic, Constraint Guardian, User Advocate) and for the Arbiter, mirroring the existing Skeptic prompting guidance, so the process is executable rather than descriptive.

Define 'Understanding Lock' inline (or reference where it is defined) and add a short Decision Log template or example entry, since both are hard gates in the exit criteria.

Trim the redundant meta-sections ('Operating Model', 'Key Principles', 'Final Reminder') into one, and fix formatting: remove the stray empty bullet in the exit criteria and separate the routing-disposition instruction into its own paragraph — also replace the circular 'When to Use' filler with real trigger conditions.

DimensionReasoningScore

Conciseness

The body is mostly list-based and efficient in form, but several sections restate the same meta-ideas: 'Operating Model', 'Key Principles', 'Failure Modes This Skill Prevents', and 'Final Reminder' all repeat 'creativity is centralized / critique is distributed / process must terminate' in slightly different words. Not 4 because these padded sections could clearly be trimmed; not 2 because there is no over-explanation of concepts Claude already knows.

3 / 5

Actionability

Roles with explicit May/May NOT scopes and a phase ordering are concrete, but key execution details are missing: only one reviewer has prompting guidance ('Assume this design fails in production. Why?'), the Decision Log has field names but no template or example entry, and 'Understanding Lock' is referenced as a gate but never defined. This sits at 3 (some concrete guidance but incomplete) rather than 4.

3 / 5

Workflow Clarity

The three phases are clearly sequenced with reviewer invocation order, an objection-respond-revise-log feedback loop, and a hard-stop exit-criteria checklist ('You may exit... only when all are true'). Not 5 because Phase 3 under-specifies how the Arbiter's decisions are recorded/reported and the undefined 'Understanding Lock' leaves a checkpoint implicit.

4 / 5

Progressive Disclosure

The single-file skill is well organized with clear section headers (roles, phases, Decision Log, exit criteria), no nested references, and no bulky reference material inlined that belongs in separate files. Minor organization gaps — a stray empty list bullet in the exit criteria, a missing separator before the routing-disposition instruction, and the vague trailing 'When to Use' section — keep it at 4 rather than 5.

4 / 5

Total

14

/

20

Passed

Description

58%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 is specific and third-person in style, clearly stating what the skill does with three concrete capabilities. Its main weakness is the complete absence of 'when to use' trigger guidance, which caps completeness and limits trigger-term quality. Adding a 'Use when...' clause with natural user phrases would lift it substantially.

Suggestions

Add an explicit 'Use when...' clause, e.g. 'Use when validating a design before implementation, stress-testing an architecture, or when the user asks for a design review or red-team of a proposed design.'

Include natural trigger synonyms users would actually say, such as 'design review', 'critique my design', 'stress-test this design', or 'peer review' — the current description lacks any natural trigger phrases.

Mention the distinguishing artifacts (Decision Log, role-gated review, exit criteria) to sharpen distinctiveness against generic brainstorming/critique skills.

DimensionReasoningScore

Specificity

The description lists several concrete actions — 'validate designs, surface hidden assumptions, and identify failure modes' — anchored to a named domain ('structured peer-review process using multiple specialized agents'). It falls short of 5 because coverage has gaps (arbitration, decision logging, constraint enforcement are not mentioned), and exceeds 3 because more than 1-2 specific actions are named.

4 / 5

Completeness

It clearly answers 'what' (simulate structured peer review to validate designs, surface assumptions, identify failure modes) but contains no 'when' guidance at all — no 'Use when...' clause or equivalent. Per the judging guidelines, a missing explicit trigger clause caps completeness at 3.

3 / 5

Trigger Term Quality

It contains relevant keywords like 'peer-review', 'designs', 'failure modes', and 'assumptions', but misses natural phrases users would say such as 'review my design', 'critique this design', or 'red-team my design'. Not 4 because a 'Use when...' trigger clause with natural terms is entirely absent, and not 2 because the keywords present are domain-relevant rather than generic.

3 / 5

Distinctiveness Conflict Risk

The multi-agent structured design-review framing is a fairly clear niche with distinct triggers, but it overlaps with generic brainstorming, critique, and code-review skills — the body itself shows it builds on a standard 'brainstorming' skill. Minor overlap risk with closely related skills places it at 4 rather than 5.

4 / 5

Total

14

/

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

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

plugins/AI-Agents-Safe-Coding-Skills-claude/skills/multi-agent-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.