CtrlK
BlogDocsLog inGet started
Tessl Logo

oma-brainstorm

Explore goals, constraints, and alternative approaches before choosing a design. Use when the user requests ideation or design exploration.

56

Quality

62%

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 ./.agents/skills/oma-brainstorm/SKILL.md

The canonical home for this skill is oma-brainstorm in first-fluke/oh-my-agent

SKILL.md
Quality
Evals
Security

Quality

Content

62%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 delivers an unusually clear, well-checkpointed workflow with concrete commands, approval gates, and error-recovery paths. Its main liability is severe structural redundancy: four parallel restatements of the same workflow inflate token cost roughly twofold, and its referenced resource files are absent from the bundle.

Suggestions

Consolidate the four parallel workflow presentations (Scheduling/Control-flow, Structural Flow scenes, Canonical workflow path, Execution Phases) into a single canonical sequence, cutting roughly half the body.

State each governing rule (one question at a time, 2-3 approaches, blind review before save, TRIZ-lite only on contradiction) once in Guardrails and remove the duplicates from scenes, phases, dependencies, and pitfalls.

Ensure referenced files (resources/triz-lite.md and the ../_shared/core/*.md set) actually exist in the skill bundle, or inline the minimal needed content so navigation targets are not dangling.

DimensionReasoningScore

Conciseness

The same rules are restated many times across parallel template sections: "one question at a time" appears in Control-flow features, Scene 2, Guardrail 2, Phase 2, and Pitfalls; TRIZ-lite optionality in Dependencies, Control-flow, Transitions, Failure/recovery, Guardrail 8, Phase 3, and References; and the whole workflow is repeated across Structural Flow, Canonical workflow path, and Execution Phases. This is noticeably verbose with several padded sections (anchor 2) rather than mostly efficient with incidental slack (anchor 3), though it avoids explaining concepts Claude already knows.

2 / 5

Actionability

Concrete, executable instruction-only guidance: specific commands ("oma state emit" + "oma state verify --checkpoint option-selection"), a named decision ("brainstorm.option-selection"), output paths ("docs/plans/designs/"), lens counts ("4-8 independent lenses"), tier definitions, and tactical/structural labels. Not 5 because key details like how blind-review lens prompts are constructed and what the comparison matrix contains are left unspecified.

4 / 5

Workflow Clarity

A clear 7-phase sequence with explicit validation checkpoints (section-by-section approval, blind review with "resolve Tier 1 before save", state verify) and genuine feedback loops (failure/recovery: "If the user cannot answer a question, propose assumptions and ask for confirmation"; transitions for rejected approaches and early implementation pressure). This matches anchor 5 rather than 4, which only requires most checkpoints.

5 / 5

Progressive Disclosure

References are one level deep and clearly signaled in a References section, but none of the cited files ("resources/triz-lite.md", "../_shared/core/context-loading.md", etc.) exist in the provided bundle, and the heavily duplicated inline content is material that could be split into those files. Fits anchor 3 (some structure, references present but not verifiable/organizational improvement needed) more than 4.

3 / 5

Total

14

/

20

Passed

Description

62%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 cleanly answers both what the skill does and when to use it in a concise, third-person voice with a distinct niche. Its main weaknesses are generic action verbs and a thin trigger vocabulary that omits the natural phrases (brainstorm, compare approaches) users would most likely say.

Suggestions

Add concrete trigger phrases to the 'Use when' clause, e.g., "Use when the user says 'I have an idea', wants to brainstorm, compare approaches, or explore a design before planning".

Name the concrete artifacts the skill produces (e.g., "produce 2-3 approach briefs and an approved design document") to sharpen the what-clause.

Include the term "brainstorm" in the description itself, since it is the skill's own name and the most natural trigger word.

DimensionReasoningScore

Specificity

"Explore goals, constraints, and alternative approaches before choosing a design" names the design/ideation domain with 2-3 actions, but the verbs are generic and no concrete artifacts (e.g., design document, comparison matrix) are named. Not 4 because it does not list several specific actions; not 2 because the domain and multiple actions are present.

3 / 5

Completeness

Both parts are explicit: what = "Explore goals, constraints, and alternative approaches before choosing a design"; when = "Use when the user requests ideation or design exploration". Not 5 because the "when" clause lacks concrete trigger phrases a user would actually say; not 3 because "when" is explicitly stated, not merely implied.

4 / 5

Trigger Term Quality

Keywords "ideation" and "design exploration" are relevant, but the most natural user phrasings ("brainstorm", "I have an idea", "compare approaches") are absent. Fits anchor 3 (some relevant keywords, missing common variations) rather than 4, since the common synonyms are missing entirely.

3 / 5

Distinctiveness Conflict Risk

"before choosing a design" and "ideation or design exploration" carve out a clear pre-planning design niche distinguishable from implementation, review, and debugging skills. Not 5 because "design" is broad and carries minor overlap risk with general design or planning skills.

4 / 5

Total

14

/

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
first-fluke/oh-my-agent
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.