Content
88%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A well-structured, actionable instruction skill: complete fill-in templates, explicit validation gates, a self-review checklist, and clean one-level references. The main weaknesses are two orphaned bundle files (references/budget_templates.md and scripts/main.py) that receive no navigation from SKILL.md, and minor rhetorical padding.
Suggestions
Add references/budget_templates.md and scripts/main.py to the References section (or describe when to use each) so the bundle's content is discoverable from SKILL.md.
Remove the redundant blockquote restating the skill's scope (the 'Grant Proposal Assistant focuses on the Specific Aims page...' line) and rhetorical flourishes like 'Every element must earn its space' to tighten token efficiency.
Clarify the relationship between the inline Step 5 self-review checklist and references/review_checklist.md — e.g., state that the reference file is the fuller pre-submission version — to avoid two overlapping checklists.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is efficient: sentence-level templates, word budgets, mechanism-specific aim counts, and checklists with no padding of concepts Claude already knows. Minor instances of over-explanation could be trimmed — e.g., the redundant blockquote restating scope ('Grant Proposal Assistant focuses on the Specific Aims page...') and rhetorical flourishes like 'Every element must earn its space.' Not a 5 due to these trimmable instances; not a 3 because there are no padded sections or unnecessary explanations. | 4 / 5 |
Actionability | For an instruction-only skill, this is fully executable guidance: a complete page skeleton with fill-in sentence templates for every section ('The overall objective of this [mechanism] is to...'), a target word count (~550–650), per-aim structure (hypothesis + approach + expected outcome in ≤3 sentences), an explicit avoid-list, a delivery checklist, and worked examples in references/specific_aims_examples.md. Common cases are covered concretely. | 5 / 5 |
Workflow Clarity | Clear 5-step sequence (clarify story → apply principles → draft → NSF variant → self-review) with explicit validation checkpoints: hypothesis must be stated before drafting ('ask them to formulate one before drafting'), flags for over-dependent aims and infeasible scope, and a checkbox self-review checklist before delivery. Not a destructive or batch operation, so no cap applies. | 5 / 5 |
Progressive Disclosure | The References section signals four one-level-deep links, all of which exist in references/ and none of which nest further. However, the actual bundle contains unreferenced content: references/budget_templates.md and a 691-line scripts/main.py are never mentioned in SKILL.md, leaving them undiscoverable. Good structure with organization gaps beyond 'minor' — but references that are present are clearly signaled, keeping this above anchor 3. | 4 / 5 |
Total | 18 / 20 Passed |