CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

literature-grounding

Use this skill when the user asks for papers, prior work, literature support, benchmark conventions, or other explicit evidence grounding from published work.

Quality

73%

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/literature-grounding/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

71%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 body delivers concrete, actionable routing guidance with a clear workflow and clean single-file organization. Its main weakness is redundancy: depth and source-routing rules are stated twice, and 'Method-critical defaults' largely restates earlier sections, costing token efficiency.

Suggestions

Merge the depth and source-routing guidance from Quick Start into Workflow steps 2–3 (or vice versa) so each rule appears exactly once.

Trim 'Method-critical defaults' to only the points not already covered by the Workflow (e.g., keep 'carry conclusions forward into proposal text or task packets', drop the restatements of non-default behavior).

Add a one-line example invocation of run_literature_research with query/topic/depth to make the guidance copy-paste ready.

DimensionReasoningScore

Conciseness

The body is mostly efficient but contains clear duplication that could be tightened: depth guidance appears in both Quick Start ('Default to depth=quick... Use depth=standard... Use depth=deep_report') and Workflow step 2 ('Use quick... Use standard... Use focused... Reserve deep_report'); source routing repeats between 'web-first orientation. Only escalate to OpenAlex / Semantic Scholar' (Quick Start) and Workflow step 3; and 'Method-critical defaults' restates workflow ideas ('Literature grounding is not a default-on behavior', 'not the default replacement for ordinary web search'). This fits anchor 3 ('mostly efficient but includes some unnecessary explanation or could be tightened') rather than anchor 4, since multiple passages are redundant rather than minor.

3 / 5

Actionability

As an instruction-only skill, the guidance is concrete and executable: it names the tool (run_literature_research), its parameters (query, topic), the depth enum (quick/standard/focused/deep_report), an escalation condition ('when paper metadata, citations, DOI/year/venue details... are actually needed' / 'when the web pass is too weak'), and a defined output pack. Minor gaps remain — no example invocation and the Output Contract ('a short summary, a small key-paper set, citations/links, confidence, and follow-up questions') has no format example — so it fits anchor 4 rather than anchor 5.

4 / 5

Workflow Clarity

The Workflow section presents four clearly sequenced steps (decide whether literature is needed → choose smallest useful depth → route sources conservatively → keep the pack clean) with a decision checkpoint in step 3 ('Start with public web... Use OpenAlex / Semantic Scholar when... the web pass is too weak'). There is no explicit validation of returned results and no error-recovery loop, so it matches anchor 4 ('clear sequence with most checkpoints present; minor validation gaps') rather than anchor 5. The destructive/batch cap does not apply since this is non-destructive research work.

4 / 5

Progressive Disclosure

This is a single-file skill (no references/, scripts/, or assets/ directories exist; 'catalysis-prior-art-and-benchmarking' in the References section is a cross-skill pointer, not a bundle path). The body is 43 lines — under the 50-line threshold — and is organized into clean sections (Overview, Quick Start, Suggested tools, Workflow, Method-critical defaults, Output Contract, References) with no content that needs splitting into external files. Per the rubric's simple-skill exception, this earns a 5.

5 / 5

Total

16

/

20

Passed

Description

65%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 excellent explicit trigger clause with natural user phrasing, but it is entirely 'when'-oriented: it never states what the skill concretely does or produces. Adding one sentence naming the skill's actual operation and outputs would lift both specificity and completeness.

Suggestions

Add a concrete 'what' statement before the trigger clause, e.g., 'Runs literature research via run_literature_research and returns a compact citation pack with key papers, links, and confidence. Use when the user asks for papers, prior work, literature support, or benchmark conventions.'

Include common synonyms users would say, such as 'citations', 'related work', or 'academic sources', to broaden natural trigger coverage.

State the deliverable explicitly (e.g., 'returns a literature pack with summary, key papers, and citations') so the skill's capability is explicit rather than implied.

DimensionReasoningScore

Specificity

The description names the domain ('papers, prior work, literature support, benchmark conventions, or other explicit evidence grounding from published work') but states no concrete skill actions — it never says what the skill actually does (e.g., run literature research, return a citation pack). This matches anchor 2 ('names the domain but actions are minimal or generic'); anchor 3 would require 1–2 explicitly stated capabilities, which are absent.

2 / 5

Completeness

The 'when' is fully explicit with concrete trigger phrases ('Use this skill when the user asks for papers, prior work, literature support, benchmark conventions...'), so the missing-trigger cap does not apply. The 'what' is only implied ('evidence grounding from published work') rather than explicitly stating the skill's operation or output — both present but the 'what' is weak, matching anchor 4 rather than anchor 5.

4 / 5

Trigger Term Quality

Trigger phrases 'papers', 'prior work', 'literature support', 'benchmark conventions', and 'published work' are natural terms users would say when needing this skill. Coverage is good but misses common synonyms such as 'citations', 'related work', and 'academic sources', so it fits anchor 4 rather than anchor 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

The published-work grounding niche ('papers, prior work, evidence grounding from published work') is clearly distinct from ordinary web search skills. Minor overlap risk remains with general research or benchmarking skills via the phrase 'benchmark conventions', fitting anchor 4 rather than anchor 5's minimal conflict risk.

4 / 5

Total

14

/

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

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Repository

fernandezbaptiste/CatMaster

Path

skills/literature-grounding/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.