Content
60%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 orchestrator overview with clear one-level-deep reference navigation and a real validation gate, but it is held back by redundancy (the 'When to Use' section and reference sub-bullets restate known information) and by body-level guidance that names steps without giving their operational criteria. The missing `examples/` files are a concrete defect in the bundle.
Suggestions
Create the `examples/example-literature-review.md` and `examples/example-research-proposal.md` files referenced in the body, or remove those references.
Trim the 'When to Use' scenario list and the per-reference sub-bullets, which duplicate the frontmatter triggers and self-describing filenames — keep one summary line per reference file.
Inline the proposal readiness gate criteria (or at least its pass/fail conditions) in the body instead of only naming it, since the workflow's key decision point currently has no operational definition in SKILL.md.
Replace generic bullets like "Consider method feasibility" and "Identify potential risks" with the specific criteria that distinguish this skill's method from Claude's default behavior.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly an efficient feature catalog, but it could be tightened: the 'When to Use' scenarios largely restate the frontmatter triggers, 'Core Features' bullets like "Consider method feasibility" and "Assess resource requirements" add nothing Claude does not already know, and each of the 8 reference files carries 3-5 sub-bullets restating what its self-describing filename already says. It is above anchor 2 because there is no concept-explaining filler, but below anchor 4 because of the duplicated 'When to Use' section and ~40 lines of redundant reference sub-bullets. | 3 / 5 |
Actionability | Some guidance is genuinely concrete — the Research Question Card fields ("hypothesis, current evidence, missing evidence, support criteria, falsification criteria, and minimal next action"), named Zotero tools ("zotero_add_items_by_identifier(..., attach_pdf=true)"), and per-artifact generation conditions under 'Conditional Outputs'. But the core execution steps are abstract pointers ("Build effective search keywords", "Apply SMART principles", "Apply the proposal readiness gate") whose actual criteria live in the reference files, leaving the body itself missing key operational detail. | 3 / 5 |
Workflow Clarity | The sequence is clearly stated ("Research interest → Idea brainstorming (5W1H) → Research Question Card → Evidence Records → Gap analysis → Proposal readiness gate → Select method or experiment → Decision") and there is an explicit checkpoint: the readiness gate plus per-artifact conditions ("Generate only when evidence-labeled sources are sufficient for synthesis"). It does not reach anchor 5 because there are no error-recovery paths (what to do when the gate fails or evidence is insufficient) and per-stage checkpoints are implicit. | 4 / 5 |
Progressive Disclosure | Good one-level-deep structure: all 8 referenced `references/*.md` files exist and are clearly signaled as "loaded on demand", and the body stays a genuine overview. It falls short of anchor 5 because the two cited example files (`examples/example-literature-review.md`, `examples/example-research-proposal.md`) do not exist — no `examples/` directory is present in the bundle — leaving dangling navigation links. | 4 / 5 |
Total | 14 / 20 Passed |