CtrlK
BlogDocsLog inGet started
Tessl Logo

agentsociety-literature-search

Use when academic literature needs to be gathered or refreshed for a research topic, especially at the beginning of a project.

56

Quality

65%

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 ./extension/skills/agentsociety-literature-search/v1.0.0/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

82%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.

This is a strong, highly actionable skill body: executable commands, exact configuration, a concrete output contract, a sequenced workflow with failure handling, and well-signaled one-level-deep references that verifiably exist in the bundle. The only deductions are minor — slight redundancy in the config/mistakes sections and inline content that could partially live in references.

DimensionReasoningScore

Conciseness

The body is dense and operational — command tables, parameter tables, exact env vars, an index schema — with no explanations of concepts Claude already knows. Minor redundancy (the fiblab MCP URL appears three times, and the extension-boundary guidance is repeated across two sections) keeps it off the 'every token earns its place' anchor.

4 / 5

Actionability

Commands are copy-paste ready with real flags and example values (e.g. `literature-full-text download --entry 1`, `--year-from 2020 --year-to 2024`), configuration is given as exact .env lines, and the index contract is a concrete JSON shape. The `$PYTHON_PATH` placeholder is explicitly resolved by pointing to CLAUDE.md for setup.

5 / 5

Workflow Clarity

The 8-step Recommended Workflow is clearly sequenced with a pre-flight config check (step 1), post-run inspection of papers/literature_index.json (step 6), and an explicit failure-recovery path (mark no-candidate, supplement notes, enrich) for this batch-writing operation. Validation is present but 'inspect' is less explicit than a hard verify step, so it matches anchor 4 rather than anchor 5's explicit validation-with-feedback-loop pattern.

4 / 5

Progressive Disclosure

The body is well-sectioned and both bundle references (references/data-sources.md, references/full-text-retrieval.md) are real files, clearly signaled one level deep with one-line descriptions in a References section. Minor gaps: the full index-contract JSON and the full-text command tables are inlined in SKILL.md, and the bundled scripts/ (search.py, full_text.py) are never referenced from the body.

4 / 5

Total

17

/

20

Passed

Description

48%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 a clear, explicit use-when clause scoped to research-project startup, but it never states what the skill actually does (search academic sources via an MCP gateway and save results to papers/) and its trigger vocabulary is narrow. It reads as half of a good description — the 'when' without the 'what'.

Suggestions

State the 'what' explicitly before the use-when clause, e.g. "Search academic literature across configured sources (arXiv, CrossRef, OpenAlex, local knowledge base) via an MCP gateway and save cataloged results to papers/."

Broaden trigger terms to the phrases users naturally say: "papers", "related work", "survey", "background research", "what has been published on X".

Distinguish the skill from adjacent ones in the description itself (e.g. note it is for searching/acquiring literature, not reading or managing a local PDF library).

DimensionReasoningScore

Specificity

The description names the domain ("academic literature", "research topic") but its only actions are the generic "gathered or refreshed" — no concrete verbs like search, save, or index. It matches the anchor 'Names the domain but actions are minimal or generic' rather than anchor 3, which requires 1-2 concrete actions.

2 / 5

Completeness

The 'when' is explicit and well-scoped ("especially at the beginning of a project"), but the 'what' — searching via an MCP gateway and saving results to papers/ — is only weakly implied inside the when-clause. It sits between anchor 2 ('only when present without what') and anchor 3, noticeably above the pure 'Use when working with documents' example.

3 / 5

Trigger Term Quality

"literature" and "beginning of a project" are natural user phrases, but common variations users actually say — "papers", "related work", "survey", "published on X" — are absent. This lands on 'Some relevant keywords but missing common variations or synonyms', not anchor 4's 'a few natural terms missing' level of coverage.

3 / 5

Distinctiveness Conflict Risk

"Academic literature ... for a research topic" carves a mostly distinct niche, but the thin trigger set leaves minor overlap risk with paper-reading and library-management skills. Not anchor 5, which expects distinct trigger phrases that pin the niche unambiguously.

4 / 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.

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
tsinghua-fib-lab/AgentSociety
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.