CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

research-lookup

Compiles current scholarly evidence for a scientific manuscript or research brief when the user explicitly asks to gather literature, references, background evidence, competing findings, or a manuscript research packet. Uses Parallel Search by default, Parallel Extract for source retrieval, Parallel Research for explicitly deep/exhaustive work, optional explicit Parallel Chat, and optional Perplexity only when requested or allowed as a failure fallback.

Quality

90%

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

SKILL.md
Quality
Evals
Security

Quality

Content

88%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-engineered operational skill: executable commands for every backend, a validated five-step workflow with error-recovery loops, and a clean reference structure. Its main weaknesses are mild verbosity and contract-level detail (Chat/Perplexity API specifics) that would sit better in the existing references file than in SKILL.md.

Suggestions

Move the beta-Chat and Perplexity contract details (model lists, request field paths like choices[].message.annotations[].url_citation, Responses-API migration history) into references/api-contracts.md, leaving a one-line summary plus the executable command in SKILL.md.

Trim justificatory prose such as the verified_references definition paragraph and the citation-count age/field-bias caveat to single clauses; the reference-quality rules already carry the operative guidance.

Consolidate scattered version/date-sensitive statements (CLI 0.9.3 pins, the 2026-09-30 review date) into the reference file or a single 'compatibility' note so SKILL.md stays stable across CLI releases.

DimensionReasoningScore

Conciseness

The body is dense and operational — routing tables, copy-paste commands, flags, and failure handling — and assumes Claude's competence without explaining basics. Minor over-explanation could be trimmed: the beta-Chat/Responses-API migration history, the paragraph defining "verified_references", and inline API field paths (e.g., "choices[].message.annotations[].url_citation") are detail that belongs in the references file. This fits 'efficient; minor instances of over-explanation' rather than the every-token-earns-its-place top anchor, and is well above the 'several unnecessary explanations' level 2.

4 / 5

Actionability

Every mode has a complete, copy-paste-ready bash command with realistic arguments (--academic, --target-references 60, --context-file, --packet-dir), plus a concrete JSON context example, setup commands, and specific CLI flags for each backend. Guidance covers the common cases and is fully executable, matching the top anchor.

5 / 5

Workflow Clarity

The manuscript workflow is clearly sequenced (capture context → run pipeline → verify with Extract → review packet → use evidence) with explicit validation checkpoints: inspect coverage.json on shortfall, verify retraction/correction status at the publisher, preserve per-URL errors in the ledger, and a Failure handling section with recovery loops (auth errors, shortfall, timeouts, missing CLI). Batch isolation and per-query error envelopes satisfy the batch-operations validation concern. This matches the top anchor's sequence-plus-feedback-loops pattern.

5 / 5

Progressive Disclosure

Structure is good: well-sectioned SKILL.md, both scripts invoked by path rather than inlined, and a single clearly-signaled one-level-deep reference ([reviewed API contracts](references/api-contracts.md), verified to exist and to link only outward to external docs). However, for a ~370-line skill only one reference file exists, and substantial contract detail (Chat model list, Perplexity request fields, API version history) is inlined in SKILL.md where the anchor for 5 expects content appropriately split across references.

4 / 5

Total

18

/

20

Passed

Description

88%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: explicit third-person capability statement, concrete trigger conditions, and backend routing detail that distinguishes it from generic search skills. The only gaps are a few missing natural synonyms and minor trigger overlap with sibling literature-review skills.

DimensionReasoningScore

Specificity

The description lists multiple concrete, third-person actions with comprehensive coverage: "Compiles current scholarly evidence", "gather literature, references, background evidence, competing findings, or a manuscript research packet", plus per-backend routing ("Parallel Search by default, Parallel Extract for source retrieval, Parallel Research for explicitly deep/exhaustive work"). It matches the anchor for multiple specific concrete actions with comprehensive coverage; the score below (minor gaps) is a worse fit since no capability area is missing.

5 / 5

Completeness

Both what and when are explicitly answered: what — "Compiles current scholarly evidence for a scientific manuscript or research brief" using named backends; when — "when the user explicitly asks to gather literature, references, background evidence, competing findings, or a manuscript research packet". This mirrors the top anchor's pattern of a clear capability statement followed by concrete 'Use when...' triggers; the 'when' is explicit, not weakly implied as at 4.

5 / 5

Trigger Term Quality

Natural trigger phrases are well covered — "literature", "references", "background evidence", "competing findings", "manuscript", "scholarly evidence", "research brief" — and would plausibly be said by a user needing this skill. A few common variations are missing (e.g., "papers", "studies", "citations", "find sources"), so it fits 'good keyword coverage; a few natural terms missing' rather than the comprehensive synonym coverage of the top anchor.

4 / 5

Distinctiveness Conflict Risk

The niche is clear (manuscript evidence packets via specific Parallel backends) and triggers are gated on explicit requests, but there is minor overlap risk with closely related skills — "gather literature" and "references" could also plausibly invoke a sibling literature-review or general web-search skill. This fits 'mostly distinct; minor overlap risk with closely related skills' better than the minimal-conflict top anchor.

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

metadata_field

'metadata' should map string keys to string values

Warning

Total

15

/

16

Passed

Repository

K-Dense-AI/scientific-agent-skills

Path

skills/research-lookup/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.