CtrlK
BlogDocsLog inGet started
Tessl Logo

ideate

Clarifies a rough idea into a precise problem specification through structured dialogue. Asks targeted questions to surface assumptions, scope, constraints, and actors. Produces a specification document defining WHAT needs to change — not HOW to change it. Use when starting a new feature, brainstorming an idea, clarifying requirements, or when a user says "I have an idea", "let's think through", "ideate", "brainstorm", "I want to build", "help me think about", "what should we build".

69

Quality

85%

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

SKILL.md
Quality
Evals
Security

Quality

Content

70%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.

A well-sequenced, gated ideation workflow with concrete question scripts and output paths, weakened by a dangling reference to the missing spec-template.md, inlined material that belongs in a reference file, and redundant restatements of the layering and questioning rules.

Suggestions

Ship the referenced spec-template.md (e.g., under references/) or inline the template directly — the link at "using the template in [spec-template.md](spec-template.md)" currently resolves to nothing, leaving Phase 3's main deliverable undefined.

Deduplicate: drop the "Specification as a Contract" layer description (restated by Writing Principles #1–2) and merge overlapping "Rules of Engagement" entries into "Question Rules" to cut roughly 40 lines.

Move the 14-section specification outline and the round-by-round question banks to a single one-level-deep reference file so SKILL.md stays an overview.

DimensionReasoningScore

Conciseness

The three-phase structure is mostly efficient, but the layering concept is explained twice — "The Specification as a Contract" lays out Layer 1/2/3 reading times that Writing Principles #1–2 ("Lead with the summary", "Layer detail progressively") restate — and "Rules of Engagement" duplicates Question Rules (e.g., "Problems before solutions" vs. "Challenge solution-shaped inputs"; "Short rounds, fast feedback. 1-2 questions per round max" vs. "Ask one round at a time (1-2 questions per call)"). Fits the 3-anchor ('could be tightened') better than 4 ('minor instances'): there are several whole redundant sections, not isolated trimmable lines.

3 / 5

Actionability

Highly actionable for an instruction-only skill: verbatim question scripts per round, a fill-in problem-statement template, numbered output steps with concrete paths (docs/spec/<feature-name>/<feature-name>-spec.md), a 14-section ordered spec outline, and a good/bad testable-requirement example ("The system MUST return HTTP 400 with a JSON error body..."). Held at 4 rather than 5 because Phase 3's core artifact depends on the referenced spec-template.md, which does not exist in the bundle — the most important executable detail is unavailable.

4 / 5

Workflow Clarity

A clearly sequenced three-phase workflow with explicit validation checkpoints: a hard GATE ("Do NOT proceed to Phase 3 until the user explicitly agrees"), confirmation options after the problem statement, "Summarise after each round" as a feedback loop, "Stop when you have enough", and a conditional Round 5. Not a 4 because no checkpoints are implicit — every phase transition is gated on explicit user agreement.

5 / 5

Progressive Disclosure

Heading structure within SKILL.md is good and the reference to the template is clearly signaled, but the only referenced bundle path — [spec-template.md](spec-template.md) — is dangling: no references/ directory or template file exists anywhere in the bundle, and bulk material that belongs in a reference file (the 14-section spec outline and the per-round question banks) is inlined in a ~250-line SKILL.md. Fits the 3-anchor (structure present but content that should be separate is inline) rather than 2, which requires minimal overall structure; rather than 4, which requires the references to actually resolve.

3 / 5

Total

15

/

20

Passed

Description

100%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: concrete third-person capabilities, a fully explicit 'Use when' clause with verbatim user phrasings, and a clear WHAT-not-HOW boundary that distinguishes it from downstream planning skills. No fluff or over-claims.

DimensionReasoningScore

Specificity

Lists multiple concrete actions in third person — "Clarifies a rough idea into a precise problem specification", "Asks targeted questions to surface assumptions, scope, constraints, and actors", "Produces a specification document defining WHAT needs to change — not HOW" — with comprehensive coverage of the skill's behavior. Not a 4 because there are no minor gaps: clarify, interrogate, and produce are all stated as concrete, distinct actions.

5 / 5

Completeness

Explicitly answers both what (clarifies ideas into a spec via targeted questions, produces a specification document) and when, via a full "Use when..." clause with concrete trigger phrases. Matches the 5-anchor example structure exactly; not a 4 because the 'when' is already fully explicit and specific.

5 / 5

Trigger Term Quality

Trigger coverage is comprehensive and natural: "starting a new feature", "brainstorming an idea", "clarifying requirements", plus verbatim user phrases "I have an idea", "let's think through", "ideate", "brainstorm", "I want to build", "help me think about", "what should we build". These are exactly the phrases a user would say; no common synonym is missing (file extensions are not applicable to this non-file skill).

5 / 5

Distinctiveness Conflict Risk

Clear niche — problem-space clarification with an explicit boundary ("WHAT needs to change — not HOW to change it") that separates it from implementation-planning skills. Distinct triggers like "ideate" and "I have an idea" carry minimal conflict risk; the broader phrases ("what should we build") are bounded by the WHAT-not-HOW framing.

5 / 5

Total

20

/

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

relative_links

Relative link issues: 2 missing

Warning

Total

15

/

16

Passed

Repository
mock-server/mockserver-monorepo
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.