CtrlK
BlogDocsLog inGet started
Tessl Logo

nanoresearch-ideation

Search academic literature and generate research hypotheses

54

Quality

61%

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

Quality

Content

72%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 content is concise and well-structured but stops at high-level process description without executable guidance or validation checkpoints. Adding concrete tool-call examples and verification steps would lift the actionability and workflow scores.

Suggestions

Add executable examples showing how to call search_arxiv and search_semantic_scholar (parameters, expected return shape).

Insert validation checkpoints, e.g. confirm dedup succeeded and rank-by-relevance criteria before gap analysis, and verify hypotheses address identified gaps.

Provide a concrete method for generating the 5-8 queries (e.g., keyword expansion or a templated prompt) rather than a bare directive.

DimensionReasoningScore

Conciseness

The body is lean and well-organized with no padding or explanation of concepts Claude already knows; every section earns its place.

5 / 5

Actionability

Steps give concrete direction ('Generate 5-8 diverse search queries', 'Search arXiv and Semantic Scholar') but lack executable code, tool-call syntax, or a concrete method for query generation and dedup, leaving guidance incomplete.

3 / 5

Workflow Clarity

Six steps are clearly sequenced, but no validation checkpoints exist for batch operations (dedup/rank), so per the batch-operation cap workflow clarity cannot exceed 3.

3 / 5

Progressive Disclosure

No bundle files exist; the body is under 50 lines with clean section headers and no need for external references, meeting the simple-skill exception for a top score.

5 / 5

Total

16

/

20

Passed

Description

50%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 conveys a clear purpose but lacks an explicit usage trigger and relies on generic phrasing. It is adequate for activation but would benefit from concrete trigger terms and a 'Use when...' clause.

Suggestions

Add an explicit 'Use when...' clause naming trigger scenarios, e.g. 'Use when the user asks for literature review, gap analysis, or novel research ideas.'

Include natural synonyms and concrete sources users mention, such as 'papers', 'arXiv', 'Semantic Scholar', and 'literature review'.

Expand the action list to reflect the full workflow (gap analysis, ranking, hypothesis selection) for stronger specificity.

DimensionReasoningScore

Specificity

The description names the domain ('academic literature') and two concrete actions ('Search', 'generate research hypotheses'), but coverage is not comprehensive — no mention of gap analysis, ranking, or synthesis.

3 / 5

Completeness

It states a clear 'what' (search literature and generate hypotheses) but provides no 'Use when...' clause, so trigger guidance is absent — capping completeness at 3 per the rubric guidelines.

3 / 5

Trigger Term Quality

It includes relevant phrases ('academic literature', 'research hypotheses') but misses natural user variations and synonyms such as 'papers', 'arXiv', 'Semantic Scholar', or 'literature review'.

3 / 5

Distinctiveness Conflict Risk

The research/literature niche is somewhat specific, but the generic phrasing could overlap with other research or analysis skills; distinct triggers are not established.

3 / 5

Total

12

/

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.

Validation15 / 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
OpenRaiser/NanoResearch
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.