CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

idea-discovery

Workflow 1: Full idea discovery pipeline to go from a broad research direction to validated, pilot-tested ideas. Use when user says "找idea全流程", "idea discovery pipeline", "从零开始找方向", or wants the complete idea exploration workflow.

Quality

72%

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 ./skills/skills-codex/idea-discovery/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

63%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 thorough, well-sequenced orchestration skill with genuinely executable commands, explicit validation gates, and real error-recovery loops. Its weaknesses are repetition of the checkpoint semantics across phases, dense jargon-heavy evidence-gate prose, and a monolithic inline structure where templates and gate mechanics belong in separate reference files.

Suggestions

Collapse the repeated per-phase 'When AUTO_PROCEED=true/false' blocks into a single reference to the 'Checkpoint execution rule' section, keeping only phase-specific prompts, to cut significant redundant tokens.

Move the evidence-gate/provisional-receipt mechanics (run_state commands, same-family vs different-family receipt rules) and the markdown templates (Research Brief, REF_PAPER_SUMMARY, final report) into one-level-deep reference files and link them from the body.

Make helper resolution self-contained by inlining the resolver pattern (or a short example invocation) instead of delegating it to '/research-pipeline', so the commands are copy-paste executable from this skill alone.

DimensionReasoningScore

Conciseness

The body is mostly skill-specific operational detail Claude would not already know (constants, evidence gates, reviewer receipts), but the AUTO_PROCEED blocking/non-blocking semantics are fully restated at Phase 1, Phase 2, and Phase 4.5 despite the dedicated 'Checkpoint execution rule' section, and the evidence-gate prose (e.g., '--provisional-advances is required because these same-family receipts are explicitly provisional') is dense and repetitive. This matches anchor 3 ('mostly efficient but includes some unnecessary explanation or could be tightened'), not anchor 4 which has only minor trimmable instances.

3 / 5

Actionability

Concrete, near-executable commands are provided throughout: '/research-lit "$ARGUMENTS" — composed: idea-stage/IDEA_REPORT.md', 'python3 <resolved-run_state.py> mark-provisional . <run_id> novelty-check --verdict-id "<agent-or-trace-id>" --reviewer "<actual-reviewer-model>"', and '/render-html "idea-stage/IDEA_REPORT.md" --no-review', plus full output templates and concrete artifact paths. It falls short of anchor 5 because key placeholders (<resolved-run_state.py>, <run_id>) are only resolvable via the external '/research-pipeline' resolver pattern, leaving a dependency gap — anchor 4 ('mostly executable guidance; concrete code or commands with minor gaps').

4 / 5

Workflow Clarity

Phases 0 through 5.6 are clearly sequenced with explicit validation (the per-stage evidence gate with PASS/BLOCKED outcomes, verdict-gated 'done' marking, 'resume <run_id> from the first non-terminal phase') and genuine feedback loops (negative verdict → 're-run that reviewer-bearing phase'; reviewer unavailable → BLOCKED). This is anchor 4 ('clear sequence with most checkpoints present; minor validation gaps') rather than 5 because helper resolution and reviewer routing depend on external context ('the same resolver pattern as /research-pipeline') that makes the flow not fully self-contained or trivially followable.

4 / 5

Progressive Disclosure

Structure is good: clear section headers, and one-level-deep references that are clearly signaled with markdown links ('[output-composition.md](../shared-references/output-composition.md)', the Output Protocols block, '[Selectable Reviewers](../shared-references/reviewer-backends.md)'). However, the body is a monolithic ~490-line file with the Research Brief template, REF_PAPER_SUMMARY template, final report template, and the dense evidence-gate/receipt mechanics all inlined, content that would be better split into separate files — anchor 4 ('good structure; most content appropriately placed; references mostly clear; minor organization gaps'), short of anchor 5's clean overview-plus-split pattern.

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 with an explicit and well-phrased 'Use when' trigger clause that includes natural multilingual trigger phrases. Its main weakness is that the 'what' stays at the level of an abstract input-to-output transformation without listing the concrete pipeline capabilities, which limits specificity and full completeness.

Suggestions

Enumerate the concrete pipeline stages in the description (e.g., 'surveys literature, brainstorms and filters ideas, verifies novelty, runs pilot experiments, and refines a proposal') so the 'what' lists specific actions rather than one abstract transformation.

Add common natural trigger variations such as 'find research ideas', 'brainstorm research topics', or 'research direction' to broaden trigger coverage beyond the three current quoted phrases.

Sharpen the trigger clause to distinguish this skill from the end-to-end /research-pipeline (e.g., 'use for idea generation only; use /research-pipeline for the full end-to-end flow') to reduce overlap risk.

DimensionReasoningScore

Specificity

The description names the domain and one concrete transformation — "go from a broad research direction to validated, pilot-tested ideas" — but never enumerates the pipeline's actual actions (literature survey, brainstorming, novelty verification, critical review, refinement). This matches anchor 3 ('names domain and 1-2 concrete actions, but not comprehensive'), falling short of anchor 4 which expects several specific listed actions.

3 / 5

Completeness

Both parts are present: the 'what' ("Full idea discovery pipeline to go from a broad research direction to validated, pilot-tested ideas") and an explicit 'Use when user says...' clause with concrete trigger phrases. It exceeds anchor 4's typical weakness (the 'when' here is very explicit), but does not reach anchor 5 because the 'what' is a single abstract pipeline sentence rather than concrete stated capabilities, matching anchor 4 ('both what and when; one could be more explicit').

4 / 5

Trigger Term Quality

Explicit natural phrases users would actually say are quoted: "找idea全流程", "idea discovery pipeline", "从零开始找方向", plus "complete idea exploration workflow". Coverage is good but misses common English variations like 'find research ideas' or 'brainstorm research topics', fitting anchor 4 ('good keyword coverage; a few natural terms missing') rather than anchor 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

The quoted triggers ("找idea全流程", "从零开始找方向") are distinctive and niche-specific, but the framing "Workflow 1" and "complete idea exploration workflow" overlaps with closely related sibling skills the body itself invokes (/research-pipeline, /research-lit, /idea-creator). This is anchor 4 ('mostly distinct; minor overlap risk with closely related skills'), not 5, since a user asking for a general 'research pipeline' could plausibly hit either skill.

4 / 5

Total

15

/

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: 5 suspicious

Warning

Total

15

/

16

Passed

Repository

wanshuiyin/Auto-claude-code-research-in-sleep

Path

skills/skills-codex/idea-discovery/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.