Content
82%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-engineered orchestrator body: deterministic routing with keyword tables, a copy-paste-ready grill-question pattern, executable onboarding commands, and a precisely specified digest format. The workflow has explicit confirm gates but lacks error-recovery branches, and there is minor redundancy across the routing sections. The References section names canons rather than linking verifiable files, and no bundle files are present.
Suggestions
De-duplicate the routing guidance: 'Never silently chain' appears twice and the 'When to invoke' symptom table overlaps the signal table — merge them into one routing section to save tokens.
Add an error-recovery branch to the workflow for the case where the lane remains ambiguous after the forcing question (e.g., ask a second discriminating question or present both lanes' digests side by side), which would raise workflow clarity to the top anchor.
Turn the 'References' section's canon names into explicit one-level-deep file links (or move them into the sub-skills' references/ directories) so citations resolve to verifiable materials.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and rule-driven with tables and templates rather than padded explanation, and it assumes Claude's competence throughout. Minor redundancy keeps it below anchor 5: 'Never silently chain' is stated twice, the 'When to invoke' symptom table overlaps the signal table, and the 'Distinct from' section restates the description's boundary list. It is well above anchor 3 since there is no explanation of concepts Claude already knows. | 4 / 5 |
Actionability | The guidance is fully concrete and copy-paste ready: a literal forcing-question template ('Q1/1: [precise question naming the two candidate lanes] / Recommended: [Lane X, because <signal-table rationale>]'), executable commands ('python3 skills/<sub-skill>/scripts/onboard.py --show'), a deterministic keyword-to-sub-skill signal table, an exact digest spec ('≤ 200 words: analyzed, top 3 findings... artifact path, and one grill challenge'), and worked grill examples. This matches anchor 5's fully-executable, common-cases-covered standard for an instruction-only skill. | 5 / 5 |
Workflow Clarity | The five-step workflow is clearly sequenced (explore → forcing question → decision-tree walk → invoke → digest) with explicit confirm gates ('(Confirm, or override?)', 'Confirm before chaining', 'Never run a sub-skill until the lane-defining decision is locked'). It falls short of anchor 5 because there is no error-recovery path for cases like a lane remaining ambiguous after the forcing question or a sub-skill invocation failing, but the checkpoints are explicit rather than implicit, keeping it above anchor 3. | 4 / 5 |
Progressive Disclosure | Sections are well organized and, as an orchestrator, routing content appropriately lives inline while detail is delegated to sub-skills ('references/ of each sub-skill', per-sub-skill onboarding and evaluator scripts). It does not reach anchor 5 because no bundle files exist in this skill and the 'References' section lists canon names (ICH E9, CONSORT, Bessemer, Rohrer) without file links, plus one external path; it stays above anchor 3 because structure and content placement are good and references are mentioned where relevant. | 4 / 5 |
Total | 17 / 20 Passed |