CtrlK
BlogDocsLog inGet started
Tessl Logo

research-ideation

This skill should be used when the user asks to "brainstorm research ideas", "use 5W1H framework", "identify research gaps", "conduct gap analysis", "start research project", "conduct literature review", "define research question", "select research method", "plan research", or mentions research project initiation phase. Provides comprehensive guidance for research startup workflow from idea generation to planning.

56

Quality

64%

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/research-ideation/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

60%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-structured orchestrator overview with clear one-level-deep reference navigation and a real validation gate, but it is held back by redundancy (the 'When to Use' section and reference sub-bullets restate known information) and by body-level guidance that names steps without giving their operational criteria. The missing `examples/` files are a concrete defect in the bundle.

Suggestions

Create the `examples/example-literature-review.md` and `examples/example-research-proposal.md` files referenced in the body, or remove those references.

Trim the 'When to Use' scenario list and the per-reference sub-bullets, which duplicate the frontmatter triggers and self-describing filenames — keep one summary line per reference file.

Inline the proposal readiness gate criteria (or at least its pass/fail conditions) in the body instead of only naming it, since the workflow's key decision point currently has no operational definition in SKILL.md.

Replace generic bullets like "Consider method feasibility" and "Identify potential risks" with the specific criteria that distinguish this skill's method from Claude's default behavior.

DimensionReasoningScore

Conciseness

The body is mostly an efficient feature catalog, but it could be tightened: the 'When to Use' scenarios largely restate the frontmatter triggers, 'Core Features' bullets like "Consider method feasibility" and "Assess resource requirements" add nothing Claude does not already know, and each of the 8 reference files carries 3-5 sub-bullets restating what its self-describing filename already says. It is above anchor 2 because there is no concept-explaining filler, but below anchor 4 because of the duplicated 'When to Use' section and ~40 lines of redundant reference sub-bullets.

3 / 5

Actionability

Some guidance is genuinely concrete — the Research Question Card fields ("hypothesis, current evidence, missing evidence, support criteria, falsification criteria, and minimal next action"), named Zotero tools ("zotero_add_items_by_identifier(..., attach_pdf=true)"), and per-artifact generation conditions under 'Conditional Outputs'. But the core execution steps are abstract pointers ("Build effective search keywords", "Apply SMART principles", "Apply the proposal readiness gate") whose actual criteria live in the reference files, leaving the body itself missing key operational detail.

3 / 5

Workflow Clarity

The sequence is clearly stated ("Research interest → Idea brainstorming (5W1H) → Research Question Card → Evidence Records → Gap analysis → Proposal readiness gate → Select method or experiment → Decision") and there is an explicit checkpoint: the readiness gate plus per-artifact conditions ("Generate only when evidence-labeled sources are sufficient for synthesis"). It does not reach anchor 5 because there are no error-recovery paths (what to do when the gate fails or evidence is insufficient) and per-stage checkpoints are implicit.

4 / 5

Progressive Disclosure

Good one-level-deep structure: all 8 referenced `references/*.md` files exist and are clearly signaled as "loaded on demand", and the body stays a genuine overview. It falls short of anchor 5 because the two cited example files (`examples/example-literature-review.md`, `examples/example-research-proposal.md`) do not exist — no `examples/` directory is present in the bundle — leaving dangling navigation links.

4 / 5

Total

14

/

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.

The description has an explicit and richly populated 'when' clause with natural trigger phrases in correct third-person voice, but the 'what' half is a single generic capability sentence ('comprehensive guidance'). Converting the 'what' into the concrete actions already implied by the trigger phrases would lift both specificity and completeness.

Suggestions

Replace "Provides comprehensive guidance for research startup workflow" with the concrete capabilities (e.g. 'Brainstorms research ideas via the 5W1H framework, runs literature searches with Zotero auto-import, identifies research gaps, and produces research question cards and proposals').

Add missing natural trigger variants such as "find a research topic", "survey the literature", or "write a research proposal".

Tighten the long quoted trigger list slightly — ten quoted phrases borders on padded; drop near-duplicates like "start research project" vs "research project initiation phase".

DimensionReasoningScore

Specificity

The trigger phrases explicitly enumerate concrete actions ("brainstorm research ideas", "identify research gaps", "conduct literature review", "define research question"), but the actual capability statement is generic — "Provides comprehensive guidance for research startup workflow from idea generation to planning" names the domain without stating what the skill concretely does. It is above anchor 2 because multiple specific action phrases are explicitly present, but below anchor 4 because the 'what' sentence itself relies on the vague word 'comprehensive' rather than listing capabilities.

3 / 5

Completeness

Both parts are present: an explicit trigger clause ("This skill should be used when the user asks to... or mentions research project initiation phase") and a 'what' ("research startup workflow from idea generation to planning"). It does not reach anchor 5 because the 'what' half is expressed only as vague 'comprehensive guidance' rather than concrete capabilities, while the 'when' half is fully explicit.

4 / 5

Trigger Term Quality

Strong natural coverage — "brainstorm research ideas", "identify research gaps", "conduct gap analysis", "conduct literature review", "select research method", "plan research" are phrases users would naturally say. It falls short of anchor 5 because common variants like "survey the literature", "find a research topic", or "write a research proposal" are absent.

4 / 5

Distinctiveness Conflict Risk

The research-initiation niche is clear and mostly distinct, anchored by specific triggers like "use 5W1H framework" and "research project initiation phase". It stays below anchor 5 because broad triggers such as "conduct literature review" and "plan research" could overlap with dedicated literature-review or research-planning skills.

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

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository
Galaxy-Dawn/claude-scholar
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.