Content
35%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is over-long and padded with generic boilerplate and redundant sections, with a broken templated 'When to Use' line. It offers concrete CLI commands and real one-level-deep references, but the core review workflow is delegated to a script rather than explained, and reference-worthy content is duplicated inline.
Suggestions
Remove generic boilerplate Claude already knows (Risk Assessment, Security Checklist, Lifecycle Status, Evaluation Criteria, Response Template, User Checkpoints) and merge the redundant Error Handling / Failure Handling / When Not to Use / Input Validation sections into one concise block.
Move the inline NIH Scoring System tables and Common Weaknesses Detected lists into the existing reference files, keeping SKILL.md a lean overview that links to them.
Fix the broken 'When to Use' line ('Use this skill when the task needs Simulates NIH study section peer review for grant proposals. Triggers.') and replace the generic Workflow with a concrete, sequenced review procedure with explicit validation checkpoints.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~350-line body is padded with generic boilerplate Claude already knows (Risk Assessment, Security Checklist, Lifecycle Status, Evaluation Criteria, Response Template, User Checkpoints) and overlapping sections (Error Handling / Failure Handling / When Not to Use / Input Validation), plus a broken templated line ('Use this skill when the task needs Simulates NIH study section peer review for grant proposals. Triggers.'). This matches the verbose/padded anchor rather than the mostly-efficient level above. | 1 / 3 |
Actionability | Provides concrete, copy-paste CLI commands ('python3 scripts/main.py --input proposal.pdf --format pdf --output review.md'), a parameters table, and a library example, but large portions are descriptive reference material rather than executable instruction, and no concrete procedure lets Claude perform a review without delegating to the bundled script. Not a 3 because guidance is incomplete as standalone instruction. | 2 / 3 |
Workflow Clarity | A 5-step Workflow and a Quick Validation section are present with some checkpoints, but the steps are generic process boilerplate ('confirm objective', 'validate scope', 'use the script') rather than a sequenced review procedure, and validation is implicit. Not a 3 because checkpoints are not explicit feedback loops tied to the core task. | 2 / 3 |
Progressive Disclosure | Five real reference files are listed one level deep with clear signals in a References section, but the body inlines large duplicated content (NIH Scoring System tables, Common Weaknesses Detected) that belongs in those references, making the SKILL.md itself a monolithic wall of text. Not a 3 because content that should be separate is inline alongside the references. | 2 / 3 |
Total | 7 / 12 Passed |