Content
81%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 body: deterministic routing logic, a five-step workflow with explicit confirmation gates at every decision point, concrete commands and copy-paste question templates, and clear deferral of lane detail to the four sub-skills. The main deductions are triplicated distinct-from content, symptom/signal table overlap, and references (canon lists, external doc paths) that don't resolve to files in this bundle.
Suggestions
Remove the duplicated distinct-from material: the intro paragraph and the 'Distinct from' section restate what the frontmatter description already says — keep one canonical copy (the section) and cut the intro repetition to save ~10 lines.
Merge the 'When to invoke' symptom table into the signal table (the symptoms are just instantiated signal keywords), or replace the symptom column with the trigger phrases from the description so the routing logic is stated once.
Make the References section resolvable: either point each canon item at the actual file in the relevant sub-skill's references/ (e.g. 'clinical-research/references/ich-e9.md') or drop the bare name-drops and the external 'documentation/implementation/research-ops-expansion-plan.md' path that cannot be verified from this skill.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with routing signal and contains no explanations of concepts Claude already knows, but distinct-from material is repeated three times (frontmatter description, intro paragraph, and the dedicated 'Distinct from' section), and the 'When to invoke' symptom table overlaps the signal table. This sits between anchors 3 and 4 — the duplication (~15 of 145 lines) is slightly more than 'minor instances that could be trimmed' but well short of 'several unnecessary explanations'. | 4 / 5 |
Actionability | Concrete guidance throughout: exact onboarding commands ('python3 skills/<sub-skill>/scripts/onboard.py --show'), a copy-paste forcing-question template ('Q1/1: ... Recommended: ... (Confirm, or override?)'), a deterministic signal table mapping keywords to sub-skills, a ≤200-word digest spec, and named artifact files. However, commands are templated on '<sub-skill>' and the referenced scripts, canon, and the 'Path-B' plan live outside this bundle and cannot be verified — concrete commands with minor gaps, i.e. anchor 4 rather than fully copy-paste-ready anchor 5. | 4 / 5 |
Workflow Clarity | Five explicitly sequenced steps (explore → one forcing question → depth-first decision walk → forked invoke → digest) with confirmation checkpoints at every decision point: 'Confirm, or override?', 'Confirm before chaining', 'Never silently chain', 'Never run a sub-skill until the lane-defining decision is locked', plus an anti-patterns checklist. No destructive or batch operations exist, so the validation cap does not apply — this matches anchor 5's explicit validation steps and checklists. | 5 / 5 |
Progressive Disclosure | Well-sectioned with clear headers, and per-lane detail (onboarding question sets, forcing-question libraries, canon) is correctly deferred to the four separate sub-skills with signaled paths ('skills/<sub-skill>/scripts/onboard.py'). Gaps: the References section name-drops canon (ICH E9, CONSORT, Bessemer) without tying it to actual files, and 'documentation/implementation/research-ops-expansion-plan.md' is an unresolvable external path; no bundle files exist in this skill to anchor navigation. Good structure with minor organization gaps — anchor 4. | 4 / 5 |
Total | 17 / 20 Passed |