CtrlK
BlogDocsLog inGet started
Tessl Logo
PluginPublic

mlava/scholar-sidekick-cli

Resolve scholarly identifiers (DOI including shortDOI aliases, PMID, PMCID, ISBN, arXiv, ISSN, ADS bibcode, WHO IRIS URL) into formatted citations (10,000+ CSL styles) and bibliography exports (BibTeX, RIS, EndNote, CSV…), and check retraction, open-access, and citation-fabrication status — from the terminal via the `scholar` CLI. Wraps the public REST API; needs Node ≥20 but no API key for the free tier. Use when the user wants to look up, cite, export, or verify a reference by DOI, PMID, PMCID, ISBN, arXiv ID, ISSN, ADS bibcode, or WHO IRIS URL from the terminal — including retraction, open-access, and fabricated-citation checks, or a whole-bibliography audit of a .bib/.ris/CSL-JSON file.

Quality

91%

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

Overview
Quality
Evals
Security
Files

Quality

Content

85%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 is an unusually strong CLI skill document: fully executable examples for every subcommand, a command table, explicit error-recovery and batch-validation workflows, and a pitfalls section — with only minor repetition of sibling-skill routing. Its one real defect is structural: the only referenced file, REFERENCE.md, is not present in the bundle, leaving the deferred authentication/exit-code detail inaccessible.

Suggestions

Ship REFERENCE.md in the skill bundle (or inline its essential content — the exit-code table and key/timeout flags — into SKILL.md) so the link is not dangling.

Consolidate the sibling-skill routing guidance (scholar-sidekick-api / -mcp) into one location — the intro blockquote — and drop the repetitions in 'When to Use' and 'Pitfalls'.

Trim editorial phrases such as 'ergonomic subcommands mean you don't hand-build JSON request bodies' that add tone but no actionable information.

DimensionReasoningScore

Conciseness

The body is dense and assumes Claude's competence — a command table, copy-paste bash, flags, exit codes — with no padding explaining known concepts. Not 5: sibling-skill guidance ('prefer scholar-sidekick-api/-mcp') is repeated three times (intro blockquote, 'When to Use', 'Pitfalls') and a few phrases like 'ergonomic subcommands mean you don't hand-build JSON request bodies' could be trimmed. Not 3: these are minor instances, not several unnecessary explanations.

4 / 5

Actionability

Every subcommand has executable, copy-paste-ready examples ('scholar format 10.1038/nphys1170 --style vancouver', 'scholar audit refs.bib --json | jq ".summary"', 'cat refs.ris | scholar audit'), plus install commands, exact flag lists, exit codes (0/1/2/3), and jq parsing patterns. Not 4: the examples cover all common cases across format, export, verify, and audit.

5 / 5

Workflow Clarity

The 'Error-recovery loop (verify)' is an explicit numbered sequence with validation checkpoints and a feedback loop (check exit code → re-run with --json → classify real mismatch vs network/usage error → report exactly, never invent a verdict), and batch operations get --fail-on-issues / --fail-on-mismatch plus a final Verification section. Not 4: validation and error-recovery loops are explicit, not just implied.

5 / 5

Progressive Disclosure

The body defers auth keys, --base-url/--timeout, and the full exit-code table to '[REFERENCE.md](REFERENCE.md)' — clearly signaled and one level deep — but no bundle files exist and REFERENCE.md is missing, so the deferred detail is unreachable. Not 4: the skill's single external reference is dangling, a real navigation failure rather than a minor organization gap. Not 2: the inline body itself is well-sectioned and appropriately sized, not monolithic or burying its references.

3 / 5

Total

17

/

20

Passed

Description

100%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 is exemplary: it names every concrete capability, enumerates the full identifier vocabulary as natural triggers, includes file extensions, and pairs a clear 'what' with an explicit 'Use when…' clause scoped to the terminal environment. Third-person voice is maintained throughout, and no vague fluff or over-claims appear.

DimensionReasoningScore

Specificity

Lists multiple concrete actions — 'Resolve scholarly identifiers (DOI including shortDOI aliases, PMID, PMCID, ISBN, arXiv, ISSN, ADS bibcode, WHO IRIS URL) into formatted citations (10,000+ CSL styles) and bibliography exports (BibTeX, RIS, EndNote, CSV…), and check retraction, open-access, and citation-fabrication status' — with comprehensive coverage of the tool's capabilities. Not 4: there are no coverage gaps; every core capability is named.

5 / 5

Completeness

Explicitly answers both 'what' (resolve, format into 10,000+ CSL styles, export to BibTeX/RIS/EndNote/CSV, check retraction/open-access/fabrication) and 'when' ('Use when the user wants to look up, cite, export, or verify a reference… including… a whole-bibliography audit'). Not 4: the 'when' clause is fully explicit with concrete trigger phrases, not merely present.

5 / 5

Trigger Term Quality

Covers natural phrases users would say — 'look up, cite, export, or verify a reference', 'retraction, open-access, and fabricated-citation checks', 'whole-bibliography audit of a .bib/.ris/CSL-JSON file' — plus the full identifier vocabulary (DOI, PMID, arXiv ID, ISBN, ISSN) and file extensions. Not 4: even uncommon variations and synonyms are present.

5 / 5

Distinctiveness Conflict Risk

Clear niche with distinct triggers — ADS bibcode, WHO IRIS URL, shortDOI aliases, citation-fabrication checks — and 'from the terminal via the `scholar` CLI' plus 'needs Node ≥20 but no API key' cleanly separates it from sibling API/MCP skills. Not 4: conflict risk is minimal, not just minor.

5 / 5

Total

20

/

20

Passed

Validation

75%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 12 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

relative_links

Relative link issues: 1 missing

Warning

Total

12

/

16

Passed

Reviewed

On this page