CtrlK
BlogDocsLog inGet started
Tessl Logo

oma-brainstorm

Design-first ideation that explores user intent, constraints, and approaches before any planning or implementation. Use for brainstorming, ideation, exploring concepts, and evaluating approaches.

59

Quality

68%

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 ./benchmarks/runs/oma/.agents/skills/oma-brainstorm/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

66%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 has a genuinely clear, well-validated workflow with explicit approval gates and error recovery, and its core directives are concrete and executable. However, it is heavily padded: the same flow is restated across Scenes, Execution Phases, the canonical path, and the Actions table, and much of the template scaffolding (SSL primitives, resource scopes, intent signatures) earns no tokens. Consolidating the duplicated workflow statements would cut the file by roughly a third without losing any actionable guidance.

Suggestions

Collapse the duplicated workflow statements into one: the 'Scenes', 'Execution Phases', and 'Canonical workflow path' sections describe the identical sequence three times — keep the Execution Phases (most concrete) and delete or merge the other two.

Remove the non-actionable meta-scaffolding: the 'SSL primitive' column in the Actions table, the 'Resource scope' table, and the 'Intent signature' section (which duplicates 'When to use') add tokens without operational guidance.

Specify the artifacts the skill must produce: what sections the design document contains and what a minimal tradeoff matrix looks like, so the RASON/VERIFY phases are executable rather than aspirational.

DimensionReasoningScore

Conciseness

The body states the same workflow three or more times in parallel forms: the "Scenes" list (PREPARE/ACQUIRE/REASON/VERIFY/FINALIZE), the "Execution Phases" list (Phase 1-6 covering the same steps), the "Canonical workflow path", and the "Actions" table all restate one flow. Meta-framework scaffolding like the "SSL primitive" column, the "Resource scope" table, and sections such as "Intent signature" duplicating "When to use" add padded tokens without new guidance — matching anchor 2 ("several unnecessary explanations or padded sections") rather than anchor 3's "some unnecessary explanation".

2 / 5

Actionability

For an instruction-only skill the guidance is mostly executable: "Asks one question at a time", "Always propose 2-3 approaches - include a recommended option with trade-off analysis", and the concrete artifact path "Save the approved design to `docs/plans/designs/`". Minor gaps remain — what a tradeoff matrix or design document section should contain is never specified — so it fits anchor 4 ("mostly executable guidance with minor gaps") rather than 5's copy-paste-ready completeness.

4 / 5

Workflow Clarity

The 6-phase sequence is explicit, with approval checkpoints ("VERIFY: Get user approval section by section", guardrail "No implementation or planning before design approval") and a dedicated "Failure and recovery" section giving feedback loops ("If the user cannot answer a question, propose assumptions and ask for confirmation"). This matches anchor 5 ("clear sequence with explicit validation steps; feedback loops for error recovery").

5 / 5

Progressive Disclosure

No bundle files exist (no references/, scripts/, or assets/), and all content is inline, but it is well-sectioned with headers and about 150 lines. The References section lists five one-level-deep, clearly signaled files, though they live outside the skill bundle (`../_shared/core/...`) and are not verifiable here. This fits anchor 4 ("good structure; references mostly clear; minor organization gaps") rather than 5, where references would be well-integrated into the body and verifiable.

4 / 5

Total

15

/

20

Passed

Description

70%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 solid description that explicitly answers both what the skill does and when to use it, with natural trigger terms. Its main weakness is abstraction — the capability statement describes process qualities rather than concrete outputs, which limits specificity and keeps it from a top score.

DimensionReasoningScore

Specificity

"Design-first ideation that explores user intent, constraints, and approaches" names the domain and 2-3 actions, but the verbs ("explores", "evaluating") are abstract — it never states a concrete deliverable like "produces a section-approved design document". This matches anchor 3 ("names domain and 1-2 concrete actions, but not comprehensive") rather than anchor 4's list of specific concrete actions.

3 / 5

Completeness

Both parts are present: the "what" ("Design-first ideation that explores user intent, constraints, and approaches before any planning or implementation") and an explicit "Use for..." clause with trigger activities. The "what" is less concrete than anchor 5's example (which lists multiple specific actions), so it fits anchor 4 ("both present; when could be more explicit or specific") — here it is the what, not the when, that keeps it below 5.

4 / 5

Trigger Term Quality

"Use for brainstorming, ideation, exploring concepts, and evaluating approaches" covers the main natural phrases a user would say. It misses common variants like "I have an idea", "design before planning", or "compare options", keeping it at anchor 4 ("good keyword coverage; a few natural terms missing") rather than 5.

4 / 5

Distinctiveness Conflict Risk

The brainstorming/ideation niche is mostly distinct, with "before any planning or implementation" clearly separating it from planning and implementation skills. "Exploring concepts" and "evaluating approaches" carry some overlap risk with general planning/design skills, matching anchor 4 ("mostly distinct; minor overlap risk with closely related skills") rather than anchor 5's clear niche.

4 / 5

Total

15

/

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.