Content
71%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 overview body with strong progressive disclosure (verified one-level-deep references and assets, all present), a clearly sequenced phase workflow with timing anchors, and mostly concrete agency-specific facts. The main cost is token weight: the 25-item generic mistakes lists and the motivational closing note pad the file without adding knowledge Claude lacks.
Suggestions
Cut the "Common Mistakes to Avoid" section down to the genuinely agency-specific items (page limits, required sections, mission mismatch, mechanism fit) and move the generic writing mistakes into writing_principles.md, which already covers them.
Delete the "Final Note" paragraph and trim the overlap between "Integration with Other Skills" and the reference listing.
Add an explicit pre-submission compliance checklist (page limits per section, required forms, font/margin rules) to Phase 4/5 so the final validation checkpoint is concrete rather than "Proofread all materials".
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The agency overviews, phase workflow, and reference pointers carry real, non-obvious information (page limits, PAPPG 24-1, CM03 form, timeline offsets), but there is measurable padding: the 25-item "Common Mistakes to Avoid" section includes generic writing advice Claude already knows ("Poor Organization", "Excessive Jargon", "Verbosity", "Inconsistent Terminology"), and the closing "Final Note" ("Grant writing is both an art and a science...") is pure fluff. Not 4: multiple sections, not just minor instances, could be trimmed without losing anything Claude doesn't already know. | 3 / 5 |
Actionability | Mostly concrete: exact page limits ("Specific Aims (1 page) + Research Strategy (12 pages for R01)", "15-page project description limit"), a copy-paste-ready command for figure generation ("python skills/scientific-schematics/scripts/generate_schematic.py ... --doc-type grant"), named forms (NSTC "CM03"), and a 5-phase schedule with dates relative to the deadline. Not 5: the deep how-to is delegated to references, and several sections (agency overviews, mistakes lists) describe rather than instruct, leaving minor gaps in what can be executed directly from SKILL.md. | 4 / 5 |
Workflow Clarity | The "Workflow for Grant Development" gives a clear 5-phase sequence, each with activities, outputs, and an explicit time anchor ("2-6 months before deadline" through "1 week before deadline"), plus revision feedback loops in Phase 3 ("Revise based on feedback") and a verification checkpoint in Phase 5 ("Verify all documents and formatting", "Confirm successful submission"). Not 5: final compliance validation (e.g., page-limit checking) is implied by "Proofread all materials" rather than given as an explicit per-artifact checklist; not 3 because the sequence and most checkpoints are explicit. | 4 / 5 |
Progressive Disclosure | The body is a genuine overview that pushes detail into 12 reference files and 3 asset templates, each cited by name with a one-line description of what it contains (e.g., "references/review_criteria.md: how NIH, NSF, DOE, and DARPA score proposals"); every referenced path was verified to exist in the bundle, and references cross-link only to sibling files at the same level (no 2+ level nesting). Not 4: structure and signaling of what lives where are clean, with only the unreferenced references/README.md as a trivial omission. | 5 / 5 |
Total | 16 / 20 Passed |