Content
78%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.
The body is a tight, prescriptive set of communication conventions with concrete ceilings, exact paths and file names, a worked invocation example, and an ordered ID-resolution procedure — genuinely actionable for an instruction-only skill. Bus operations are sequenced with verification steps, and the one deep-dive topic is properly split into a clearly signaled one-level reference. Only minor tightening of generic style advice and a worked example or two separate it from top marks.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and prescriptive, carrying almost exclusively project-specific rules Claude could not infer (the word-ceiling table of 100/250/500, bus file clearing protocol, slug resolution order) rather than explanations of known concepts. Minor trimmable over-explanation remains — the "Wording" and "Form" bullets restate general style advice ("Use everyday words, concrete subjects and active verbs", "Put commands in code blocks") Claude already follows — so it fits anchor 4 rather than the every-token-earns-its-place bar of 5. | 4 / 5 |
Actionability | Guidance is concrete and executable throughout: numeric reply ceilings (100/250/500 words), exact paths and file names (".apm/bus/", "task.md", "report.md", "handoff.md", "manager/"), a worked invocation example ("`apm-5-check-reports frontend-agent` in the Manager's chat"), and an ordered matching procedure ("an exact match first, then a prefix, then the closest plausible name"). It is not 5 because there is no worked example of ID resolution matching or a sample bus message, and formats are deferred to role guides — appropriate, but it leaves minor gaps. | 4 / 5 |
Workflow Clarity | The bus protocol is an explicitly sequenced workflow with verification ("Read a bus file before writing it... verify the written content before announcing it", "After you process an incoming message, clear its file before you write your outgoing one"), reply drafting has a checkpoint ("check that it opens with the substance and fits its ceiling"), and ID resolution has ordered fallbacks with User confirmation. It is not 5 because there is no error-recovery loop when verification fails, and section 2 is a convention list rather than a sequenced process. No destructive or batch operation is involved, so no cap applies. | 4 / 5 |
Progressive Disclosure | The ~50-line body is cleanly sectioned (1/2/3 with 3.1/3.2) with no inlined bulk that belongs elsewhere, and the single deep-dive topic is split out to a clearly signaled, one-level-deep reference ("{SKILL_DIR:apm-communication}/bus-integration.md describes how"). No bundle directories (references/, scripts/, assets/) are provided — the bundle is SKILL.md alone — so per the simple-skill guideline the well-organized structure with its one clearly signaled external reference earns the top score. | 5 / 5 |
Total | 17 / 20 Passed |