CtrlK
BlogDocsLog inGet started
Tessl Logo

research-lit

Search and analyze research papers, find related work, summarize key ideas. Use when user says "find papers", "related work", "literature review", "what does this paper say", or needs to understand academic papers.

63

Quality

75%

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

Quality

Content

62%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 highly actionable, well-sequenced multi-source retrieval guidance with genuine error-recovery loops, but it is a 465-line monolith that repeats the same fetcher-resolution boilerplate six times and inlines per-source detail that belongs in reference files or scripts. Moving source-specific blocks out of SKILL.md would fix both the conciseness and disclosure weaknesses.

Suggestions

Extract the six near-identical $ARIS_REPO/fetcher-resolution bash blocks into a single shared reference (e.g. references/fetcher-resolution.md) or a helper script invoked once, removing ~180 lines of boilerplate.

Move the per-source detail (Semantic Scholar, DeepXiv, Exa, Gemini, OpenAlex sections) into references/sources.md and keep only the source table plus selection rules in SKILL.md, collapsing the triple statement of source-selection rules (Constants, Source Selection, examples) into one.

Delete the 'Why use X?' explanatory paragraphs (e.g. 'Many IEEE/ACM journal papers are not on arXiv. S2 fills the gap...') — Claude already knows this; a one-line 'venue-only papers + citation metadata' in the source table conveys the same value.

DimensionReasoningScore

Conciseness

The ~465-line body repeats the same $ARIS_REPO/fetcher-resolution bash boilerplate verbatim six times (arXiv, Semantic Scholar, DeepXiv, Exa, OpenAlex, download blocks), re-states source-selection rules three times (Constants, Source Selection, and the examples block), and pads with explanations Claude does not need ("Why use Semantic Scholar? Many IEEE/ACM journal papers are not on arXiv. S2 fills the gap..."). This is noticeably verbose with several padded/redundant sections rather than merely 'could be tightened' (3), and it is not a 1 because the material is operational instruction rather than tutorial-style concept explanation.

2 / 5

Actionability

Mostly executable: complete copy-paste bash blocks with explicit fallback WARN paths, a literal Gemini MCP call payload, exact glob patterns, and exact output table headers. Not a 5 because commands contain unsubstituted placeholders ("QUERY", ARXIV_ID in the deepxiv block), and the fan-out section's "Use fresh spawn_agent shards when delegation is available" references a delegation mechanism that is never made concrete.

4 / 5

Workflow Clarity

The sequence (Step 0a/0b/0c → 1 → 6) is explicit with numbered sub-steps, and validation/feedback loops are present throughout: `|| echo "WARN: ..."` continue-on-failure handling with WebSearch fallback, "Verify each PDF > 10 KB" on the batch download, the mandated WARN when all PAPER_LIBRARY paths miss, and "If the wiki path or format is unclear, ask before writing. Do not invent a wiki location." This matches the anchor with explicit validation steps, error-recovery loops, and checks for a batch operation.

5 / 5

Progressive Disclosure

The three external references ([fan-out-pattern.md], [integration-contract.md], [output-composition.md] under ../shared-references/) are one level deep and clearly signaled, but no references/, scripts/, or assets/ bundle exists, and roughly 200 lines of per-source fetcher-resolution bash and de-duplication rules are inlined in SKILL.md when they clearly belong in a shared reference or script. Structure exists and navigation is possible, but content that should be separate is inline — between the 3 and 4 anchors, closer to 3.

3 / 5

Total

14

/

20

Passed

Description

87%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 that clearly states what the skill does and gives explicit, natural 'Use when' trigger phrases. Minor room to grow by naming concrete outputs (citation tables, BibTeX export) and a few more synonyms like "survey" or "prior work".

DimensionReasoningScore

Specificity

The description lists several concrete actions — "Search and analyze research papers, find related work, summarize key ideas" — comparable to the good example "Extract text and tables from PDF files, fill forms, merge documents". It falls short of a 5 because "analyze" and "summarize key ideas" are generic verbs with no concrete mechanisms (sources, outputs like citation tables or BibTeX), and it is above 3 because more than 1-2 specific actions are named.

4 / 5

Completeness

It explicitly answers both: what ("Search and analyze research papers, find related work, summarize key ideas") and when ("Use when user says \"find papers\", \"related work\", \"literature review\"...") with concrete trigger phrases, matching the top anchor exactly. Not below 5 because neither half is vague or merely implied.

5 / 5

Trigger Term Quality

Quoted trigger phrases — "find papers", "related work", "literature review", "what does this paper say", "understand academic papers" — are natural things a user would say, matching the 'PDF files, forms, document extraction' level. Not a 5 because common synonyms like "survey", "prior work", "state of the art", or "background section" are missing.

4 / 5

Distinctiveness Conflict Risk

"related work" and "literature review" are distinctly academic-research triggers with minimal overlap risk against generic document or web-search skills, and the description scopes itself to research papers. Not a 4 because no closely related skill's triggers (e.g., paper writing, PDF extraction) plausibly collide with these phrases.

5 / 5

Total

18

/

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

Warning

Total

15

/

16

Passed

Repository
wanshuiyin/Auto-claude-code-research-in-sleep
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.