Content
85%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 methodological skill body: a clearly sequenced research workflow with explicit validation gates and feedback loops, lean prose that assumes competence, and clean one-level-deep progressive disclosure into real reference files. Minor tightening of the opening stance prose and slightly more inline detail would lift the actionability/conciseness dimensions.
Suggestions
Trim the narrative stance-setting in the Overview ('The role is a senior researcher...', 'This is not a search engine and not a bullet-point answer') to the essentials to improve conciseness.
Inline one or two concrete artifacts for actionability — e.g. a short example of the MECE taxonomy structure or a sample search-perspective keyword set — alongside the references.
Consider a one-line explicit validation/retry statement near Phase 1 candidate verification so the feedback loop is visible inline rather than only via the citation-protocol reference.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Efficient and assumes Claude's competence — it never explains known concepts (what a survey or MECE is) — but the opening overview and a few discursive stance-setting passages could be trimmed slightly. | 4 / 5 |
Actionability | Provides concrete, specific guidance (three-to-five named search perspectives, the six-gate table, per-field evidence standards), with detailed protocols appropriately delegated to reference files rather than inlined. | 4 / 5 |
Workflow Clarity | Clear sequence (Step 0 brief → Phase 1 scout → Phase 2 synthesize → presentation) with explicit validation via the six gates, severity ratings, failure routes, and a feedback loop ('Iterate until every gate is CLEAR and the self-adversarial pass stops finding corrections'). | 5 / 5 |
Progressive Disclosure | SKILL.md is an overview pointing to seven real, clearly signaled one-level-deep reference files (e.g. references/citation-protocol.md); verified the reference files contain no nested references, so navigation stays flat and easy. | 5 / 5 |
Total | 18 / 20 Passed |