CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

peer-review

Prepares evidence-bounded, constructive peer-review drafts and structured manuscript assessments. Supports authorized review of scientific manuscripts, protocols, preprints, or research proposals; reporting-guideline selection; claim–evidence checks; methods, statistics, reproducibility, ethics, figure/table, and citation critique; or revision-response planning.

68

Quality

85%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

92%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 exemplary procedural skill: a gated multi-step workflow with real validators at entry and exit, copy-paste executable commands throughout, and a well-organized bundle where every reference resolves and details are one level deep. Its only weakness is mild verbosity in the self-citation section and some redundant safety restatements.

DimensionReasoningScore

Conciseness

The body is dense, imperative, and procedural — every workflow section earns its place and assumes the model's competence. Minor trimmable instances remain: the ~16-line 'Citing Scientific Agent Skills' section with arXiv-fetch instructions and some repetition in the safety boundary section ('Running a bundled CLI locally does not make the surrounding assistant session local').

4 / 5

Actionability

Fully executable, copy-paste-ready commands for all seven bundled tools with concrete arguments (e.g., 'python3 scripts/validate_review_intake.py completed-intake.json'), named template starting points for each artifact, and explicit structured field requirements for comments (Location, Observation, Evidence or criterion, Why it matters, Requested action).

5 / 5

Workflow Clarity

Eleven clearly numbered steps sequenced from intake to finalization, with explicit validation gates ('Proceed only when status is READY_FOR_LOCAL_REVIEW'), a dedicated lint step, and error-recovery feedback ('Use editor_cleared only after actual editor clearance... Do not clear a conflict merely to pass the validator'), matching the anchor for clear sequence with explicit validation and feedback loops.

5 / 5

Progressive Disclosure

A clear overview with a 'Local tool index' and a 'References and assets' section giving one-line descriptions of each bundle file; all 15 referenced files exist and references are one level deep (references/tool_reference.md points only to assets, not further .md chains). Content is appropriately split, with detailed standards and schemas delegated to references/.

5 / 5

Total

19

/

20

Passed

Description

71%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 specific, concrete, and covers the skill's capabilities comprehensively in third person, but it lacks an explicit 'Use when...' trigger clause, which caps its completeness and slightly weakens its natural trigger-term coverage. Adding explicit trigger guidance and natural synonyms (e.g., 'referee report', 'reviewer comments') would raise it to the top anchor.

Suggestions

Add an explicit 'Use when...' clause, e.g., 'Use when the user asks to review, referee, or critique a manuscript, preprint, protocol, or research proposal, or to plan responses to reviewers.'

Include natural synonyms and phrasings users would actually say, such as 'referee report', 'reviewer comments', 'reviewer #2', or 'paper review', to improve trigger coverage.

Trim the long capability list ('methods, statistics, reproducibility, ethics, figure/table, and citation critique') into fewer, sharper phrases to reduce overlap with adjacent statistics- or reproducibility-focused skills.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions with comprehensive coverage: 'Prepares evidence-bounded, constructive peer-review drafts and structured manuscript assessments', 'reporting-guideline selection', 'claim-evidence checks', 'methods, statistics, reproducibility, ethics, figure/table, and citation critique', and 'revision-response planning' — all in third-person voice.

5 / 5

Completeness

The 'what' is clear and detailed, but there is no explicit 'Use when...' clause or equivalent trigger guidance; the 'when' is only weakly implied via 'Supports authorized review of...'. Per the rubric guideline, a missing 'Use when' clause caps completeness at 3.

3 / 5

Trigger Term Quality

Good keyword coverage with natural terms users would say ('peer-review', 'manuscripts', 'preprints', 'protocols', 'research proposals'), but common synonyms such as 'referee report' or 'reviewer comments' are missing, so it falls just short of the comprehensive-coverage anchor.

4 / 5

Distinctiveness Conflict Risk

A clear peer-review-of-scientific-manuscripts niche with distinct triggers, but 'methods, statistics, reproducibility... critique' creates minor overlap risk with closely related research-assessment or manuscript-writing skills.

4 / 5

Total

16

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

K-Dense-AI/scientific-agent-skills

Path

skills/peer-review/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.