Conduct professional peer reviews for papers or theses, providing structured evaluations and improvement suggestions; use when you need a pre-submission assessment, an internal review, or academic quality control.
55
62%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./scientific-skills/Academic Writing/peer-review/SKILL.mdQuality
Discovery
75%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 well-structured with clear 'what' and 'when' components, making it functionally complete. Its main weaknesses are moderate specificity (it could enumerate more concrete review actions) and trigger term coverage that misses common user phrasings like 'manuscript', 'critique', or 'journal submission'. The use of second person ('you need') in the 'when' clause is a minor style issue but doesn't severely impact utility.
Suggestions
Add more specific concrete actions such as 'evaluating methodology, checking argument coherence, assessing citation quality, identifying logical gaps'
Expand trigger terms to include natural variations like 'manuscript review', 'paper critique', 'dissertation feedback', 'journal submission review', 'research paper evaluation'
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | It names the domain (peer reviews for papers/theses) and mentions some actions (structured evaluations, improvement suggestions), but doesn't list multiple concrete specific actions like identifying methodology flaws, checking citations, evaluating argument structure, etc. | 2 / 3 |
Completeness | Clearly answers both what ('conduct professional peer reviews, providing structured evaluations and improvement suggestions') and when ('use when you need a pre-submission assessment, an internal review, or academic quality control') with explicit trigger guidance. | 3 / 3 |
Trigger Term Quality | Includes some relevant terms like 'peer review', 'papers', 'theses', 'pre-submission assessment', and 'academic quality control', but misses common natural variations users might say such as 'manuscript review', 'feedback on my paper', 'research paper critique', 'dissertation review', or 'journal submission'. | 2 / 3 |
Distinctiveness Conflict Risk | The description carves out a clear niche around academic peer review specifically, with distinct triggers like 'pre-submission assessment' and 'academic quality control' that are unlikely to conflict with general writing or editing skills. | 3 / 3 |
Total | 10 / 12 Passed |
Implementation
50%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill provides a reasonable framework for conducting peer reviews with a clear workflow and structured template. Its main weaknesses are verbosity in describing concepts Claude already understands (what novelty and significance mean), lack of concrete examples showing good review output with realistic content, and missing validation steps in the workflow. The referenced bundle files are absent, undermining the progressive disclosure structure.
Suggestions
Remove or significantly trim the 'When to Use', 'Key Features', and 'Key Parameters / Criteria' sections — Claude understands these concepts and they consume tokens without adding actionable guidance.
Add a concrete, realistic example of a completed review (even a brief one) showing what good review comments look like, rather than only providing a fill-in-the-blank template.
Add validation checkpoints to the workflow, such as: verify recommendation severity matches issue severity, cross-check that all major issues have actionable fixes, and confirm results assessment aligns with the final recommendation.
Provide the referenced bundle files (assets/peer_review_template.md, references/guide.md) or remove the references to avoid broken links and consolidate the content appropriately.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill includes some unnecessary sections like 'When to Use' and 'Key Features' that describe the skill's purpose rather than instructing Claude on how to perform it. The 'Key Parameters / Criteria' section largely restates concepts Claude already understands about academic review. However, the workflow and template sections are reasonably efficient. | 2 / 3 |
Actionability | The template provides a concrete structure for output, and the workflow steps are clear. However, the guidance is largely fill-in-the-blank with bracketed placeholders rather than fully executable examples with realistic content. The instructions describe what to evaluate but don't provide concrete examples of good vs. bad review comments or specific analytical techniques. | 2 / 3 |
Workflow Clarity | The 5-step review workflow is clearly sequenced and logically ordered. However, there are no validation checkpoints or feedback loops — for instance, no step to verify that all major issues have corresponding suggested fixes, no cross-check between the recommendation severity and the issues found, and no explicit verification that the output matches the template structure. | 2 / 3 |
Progressive Disclosure | The skill references `assets/peer_review_template.md` and `references/guide.md` for detailed content, which is good progressive disclosure structure. However, no bundle files are provided, so these references are unverifiable and potentially broken. The main file also includes substantial inline content (the full template) that partially duplicates what the referenced template file should contain. | 2 / 3 |
Total | 8 / 12 Passed |
Validation
90%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 10 / 11 Passed | |
73f6514
Table of Contents
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.