CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

inno-idea-generation

Generates research ideas for a defined research problem. Reads the project's literature and context, explores directions with research ideation lenses, writes three full candidate proposals, and selects one through an explicit gate. Writes Ideation/ideas/selected_idea.txt for inno-idea-eval. Use when the user wants research ideas, hypotheses, a research direction, or a method idea for a paper or project. Runs after literature survey and before inno-idea-eval.

Quality

87%

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

81%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-engineered process skill: the workflow is clearly sequenced with explicit validation and failure handling, and the on-disk reference files match their described roles. The main defect is integrity of the bundle itself — all three prompt templates that Steps 3–4 depend on are referenced but missing, which degrades both actionability and progressive disclosure.

Suggestions

Ship the missing prompts/ files (build_idea_query.md, new_idea_prompt.md, build_idea_selection_query.md) or inline their parameter tables in SKILL.md, since Steps 3–4 instruct the reader to fill them but they are absent from the bundle.

Make the directory-structure listing match the actual bundle: either include the prompts/ entries as real files or remove them so navigation never dead-ends.

Consolidate the write-order and file-naming rules that currently appear in Outputs, Step 3, and the Checklist to trim redundancy and token cost.

DimensionReasoningScore

Conciseness

The body is dense and operational — an input table with exact JSON paths, an output file tree, a full JSON log schema, per-step save targets, a config table, and a checklist — with no explanations of concepts Claude already knows. It falls short of a 5 only through minor redundancy (write-order and file-naming rules repeated across Outputs, Step 3, and the Checklist; the refinement section restates handoff details).

4 / 5

Actionability

Guidance is highly concrete (exact filenames, complete JSON log format, 'SELECTION_THRESHOLD (default 7/10)', 'Never list a paper you did not open', 'set grounded: false'), but Steps 3–4 instruct 'fill prompts/build_idea_query.md', 'prompts/new_idea_prompt.md', and 'prompts/build_idea_selection_query.md', none of which exist in the bundle, so those steps cannot be executed exactly as written. It stays above 3 because the body itself still specifies content, order, and formats precisely enough to act on.

4 / 5

Workflow Clarity

Steps 1–5 are clearly sequenced with per-step save targets, an explicit write-order rule ('write the .txt / .md file first, then the .json log'), a pre-run clarification gate ('Ask at most three short questions'), and explicit error-recovery paths ('If no candidate passes, do not promote one silently... tell the user which criteria failed, and propose one of...'). Validation checkpoints (gate scoring, threshold, honest novelty labels, grounded flag) and a closing checklist match the top anchor.

5 / 5

Progressive Disclosure

Structure is strong: a directory tree with one-line descriptions, and each reference invoked at the exact step that needs it ('Read references/idea_agent_instructions.md before Step 1', 'Use references/ideation_frameworks.md' in Step 2), one level deep. However, 3 of the 7 referenced paths — the entire prompts/ directory — do not exist in the bundle, so navigation dead-ends at the core Steps 3–4; that is more than a trivial gap, keeping it below the 5 anchor.

4 / 5

Total

17

/

20

Passed

Description

88%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: third-person, concrete, and complete, with an explicit 'Use when' trigger clause and clear pipeline positioning that separates it from neighboring skills. The only softness is trigger synonym coverage (no 'brainstorm' or 'research proposal' phrasing), which leaves a small chance a user's natural phrasing would not match.

DimensionReasoningScore

Specificity

It lists multiple concrete actions covering the entire workflow — 'Reads the project's literature and context', 'explores directions with research ideation lenses', 'writes three full candidate proposals', 'selects one through an explicit gate', 'Writes Ideation/ideas/selected_idea.txt' — in third person, matching the comprehensive top anchor. It is not a 4 because there are no coverage gaps: input reading, exploration, drafting, selection, and the output artifact are all named.

5 / 5

Completeness

It explicitly answers both questions: the 'what' is the full action chain (read literature → explore lenses → write three candidates → select via gate → write selected_idea.txt), and the 'when' is a concrete 'Use when...' clause with trigger phrases, further anchored by 'Runs after literature survey and before inno-idea-eval'. This matches the 5 anchor exactly; the 4 anchor's 'when could be more explicit' does not apply.

5 / 5

Trigger Term Quality

'Use when the user wants research ideas, hypotheses, a research direction, or a method idea for a paper or project' covers the main natural phrases with variations, but misses common synonyms a user might say such as 'brainstorm', 'research proposal', or 'novel idea'. Good coverage with a few natural terms missing fits the 4 anchor; it is above 3 because the core phrasings users would actually utter are present.

4 / 5

Distinctiveness Conflict Risk

The niche is clear — research idea generation for a paper or project, positioned within a named pipeline ('Runs after literature survey and before inno-idea-eval') — which delineates it from adjacent skills. Minor overlap risk remains with generic brainstorming or ideation skills since 'research ideas' is not uniquely identifying, fitting the 4 anchor rather than the minimal-conflict 5 anchor.

4 / 5

Total

18

/

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

OpenLAIR/dr-claw

Path

skills/inno-idea-generation/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.