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 maximally lean delegating stub: it points to a canonical playbook with exact paths, a follow-on rules file, and a precise platform substitution rule. Its weakness is that it carries none of its own substance — no overview of the playbook's contents and no examples — so its value is entirely outsourced to files outside this bundle.
Suggestions
Add a 2-3 sentence overview of what the playbook covers (agent loop, verifiers, termination conditions, named patterns) so the body is not a bare pointer and a reader can decide relevance without opening the external file.
Clarify the relationship between the playbook and '.agents/rules/cog.md' — e.g., whether cog.md rules override the playbook when they conflict — to remove the one ambiguity in the sequence.
State explicitly that '.claude/skills/loop-engineering/SKILL.md' is a separate central playbook (not this file), since the self-referential path invites an infinite read-execute loop if the paths coincide.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The five-line body is lean and assumes Claude's competence — 'Read ... and execute it exactly as written — that file is the authoritative playbook. Then follow ...' with one substitution rule — every token earns its place. No padding, no explanation of concepts Claude already knows. | 5 / 5 |
Actionability | The guidance is concrete and executable in form — exact paths ('.claude/skills/loop-engineering/SKILL.md', '.agents/rules/cog.md', '.agents/agents/<name>.md') and a specific tool ('invoke_subagent'). It is not a 5 because all substantive instruction lives in an external file, so the body alone provides no examples or steps for the common cases; it is well above a 3 since nothing is pseudocode or vague. | 4 / 5 |
Workflow Clarity | The sequence is clear and ordered — read and execute the authoritative playbook, then follow '.agents/rules/cog.md', with an explicit conditional rule for worker delegation. Not a 5 because there are no checkpoints clarifying how the playbook's instructions and cog.md rules interact when they conflict; not a 3 because no risky/destructive operation requires validation here. | 4 / 5 |
Progressive Disclosure | References are one level deep and clearly signaled with exact paths, and splitting the substance into a shared canonical playbook is an appropriate content split for a 'shared reference' skill. It falls short of a 5 because the body is a pure pointer with no overview or summary of what the playbook contains, leaving navigation context thin. | 4 / 5 |
Total | 17 / 20 Passed |