CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

ideate

The idea field is empty, narrowed too early, or thin: the user can then see one map from their words and what they name — frames, branches, idea origins, the unexplored — and take it, nothing chosen.

Quality

56%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./heuresis/skills/ideate/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

42%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 skill is a rigorous, internally consistent behavioral contract with a genuinely well-structured references bundle, but it is delivered as a dense ~500-line formal monograph rather than an operational skill file. Redundant restatement of the same invariants, abstract axiom-based direction in place of worked examples, and a workflow the reader must reassemble from scattered sections hold it to the middle of the scale.

Suggestions

Move the Lean formal contract to a references file (e.g. references/contract.md) and keep in SKILL.md only the operational summary — the flow, the invariants once, and the user-facing realization — cutting the body to a fraction of its current size.

Add one worked example: a sample classification relay and a rendered frame map / round offer in everyday language, so the abstract rules ("targets", "the map", "the offer") are grounded in concrete output the model can pattern-match.

Consolidate the invariants currently repeated in FLOW, MORPHISM, axiom doc comments, and Rules into a single list, and present the run's step sequence as one numbered walkthrough with the decision points (taking, fresh invocation, non-bearing turn) as explicit checkpoints.

DimensionReasoningScore

Conciseness

The body is a ~500-line monolith in which the same invariants ("never eliminates, ranks, or scores") are restated across FLOW, MORPHISM, axiom doc comments, Rules, and Known Limitations, and the Definition carries literature-review padding ("Runco & Acar, 2012", "Wadinambiarachchi et al., 2024") plus a Lean formal block whose prose commentary duplicates the Protocol section. It does not explain concepts Claude already knows, so not a 1, but several sections are noticeably padded and redundant — anchor 2.

2 / 5

Actionability

Concrete guidance exists — "read `references/blank-entry.md` before presenting it", "read `references/seeded-entry.md` before the first pass", "present continue first and 'Take this field as it stands' second" — but the bulk is a formal contract whose axioms are "yours to judge", with no worked example of a relay, a rendered map, or a round's offer. Some concrete guidance, incomplete — anchor 3; not 4 because the operational core is buried in abstract formalism rather than executable direction.

3 / 5

Workflow Clarity

A sequence is present (FLOW: "start: the records `reference` names, read → the classification relay → Blank: … → the map"; the `ideate` definition's Taken/Invoked/Reaches decision branches) but it is scattered across the formal block, PHASE TRANSITIONS, Protocol, and Rules with no consolidated step list, and checkpoints (relay correction, map completeness, the taking gate) are implicit rather than stated as verification steps. Anchor 3 — sequence present but checkpoints missing or implicit; not 4 because the multi-step process requires reassembly by the reader.

3 / 5

Progressive Disclosure

The bundle structure is genuinely good — all three references exist, are one level deep, and are clearly conditionally signaled ("read `references/round-composition.md` before composing when a term's rendering has to hold across the session") — but the entire ~500-line Lean formal block is inlined in SKILL.md when it is exactly the deep-detail material that belongs in a reference file, matching the anchor's "content that should be separate is inline." Not 4 because most of the body's mass is misplaced relative to a lean overview; not 2 because the references that do exist are well organized and never nested.

3 / 5

Total

11

/

20

Passed

Description

53%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 communicates a distinctive concept (divergent widening of a thin idea field, ending in the user's taking, nothing chosen) in appropriately third-person voice, and it names the map's concrete contents. Its weaknesses are the absence of an explicit trigger clause and of the natural vocabulary users would actually employ, plus an abstract rendering of what the skill does.

Suggestions

Add an explicit trigger clause, e.g. "Use when the user invokes /ideate to brainstorm or widen an empty or too-narrow set of ideas" — the description currently omits both the invocation requirement and any 'use when' guidance.

Include natural user phrasings such as "brainstorm", "give me ideas", "stuck", "out of options", or "widen the field" so trigger matching works on the words users actually say.

State the action in plain operational form ("Generates a frame-parallel map of candidate ideas with their origins…") instead of the current circumlocution about the user seeing a map, to sharpen the what-does-this-do answer.

DimensionReasoningScore

Specificity

The description names the deliverable concretely — "one map from their words and what they name — frames, branches, idea origins, the unexplored" — and the action "take it, nothing chosen", which is domain plus 1-2 concrete actions rather than a list of several specific operations. Not 4 because the actions are characterized abstractly rather than enumerated; not 2 because it goes well beyond a bare domain label.

3 / 5

Completeness

The "what" is clear (a map of frames, branches, origins, and unexplored areas the user can take, "nothing chosen"), but the "when" is only the state clause "The idea field is empty, narrowed too early, or thin" — there is no "Use when…" or equivalent explicit trigger guidance, and no mention that the skill activates only on direct /ideate invocation. Per the guideline, missing explicit trigger guidance caps completeness at 3.

3 / 5

Trigger Term Quality

Some relevant natural keywords appear ("idea field is empty", "narrowed too early, or thin"), but common user phrasings like "brainstorm", "give me ideas", "stuck", or "more options" are missing, and much of the vocabulary ("frames", "branches", "idea origins", "the unexplored") is protocol jargon users would not naturally say. This fits the anchor for some relevant keywords while missing variations and synonyms.

3 / 5

Distinctiveness Conflict Risk

The divergence-without-selection framing ("take it, nothing chosen", "the unexplored") carves a clear niche distinct from document- or code-processing skills, with only minor overlap risk against other ideation/brainstorming skills. Not 5 because "idea field is empty… or thin" could still co-trigger with a generic brainstorming skill.

4 / 5

Total

13

/

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

skill_md_line_count

SKILL.md is long (559 lines); consider splitting into references/ and linking

Warning

Total

15

/

16

Passed

Repository

jongwony/epistemic-protocols

Path

heuresis/skills/ideate/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.