Content
92%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 orchestration skill: the body carries only routing, eligibility, and write-boundary decisions while every procedural detail lives in clearly signaled, per-step references, all of which are present in the bundle. The only quality nit is mild redundancy in the mode-detection and non-interactive-contract prose.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense, decision-oriented prose with no padding and no explanation of concepts Claude already knows — every sentence encodes a rule, boundary, or routing decision. It sits at 4 rather than 5 because a few clauses are over-enumerated for the top level, e.g. the Mode Detection token combinatorics ('multiple `depth:` tokens, or a `depth:` token without non-interactive intent') and the non-interactive contract being restated across Mode Detection, Choosing the path, and Full Mode step 2, which could be tightened or pushed into a reference. | 4 / 5 |
Actionability | For an instruction-only skill the guidance is fully concrete: exact invocation forms ('/ce-compound mode:non-interactive depth:lightweight [context]'), exact paths ('<repo-root>/.compound-engineering/config.yaml', 'git rev-parse --show-toplevel'), named required reads per step ('Read `references/modes.md` before step 1'), and exact terminal signals to emit ('Documentation complete', 'Documentation skipped'). Not a 4 because there are no meaningful gaps in the executable guidance. | 5 / 5 |
Workflow Clarity | The Full Mode section gives a numbered 1-6 sequence where 'Each reference is a required read at the step that names it', with an explicit parallelism instruction ('start it *after* launching the parallel block') and an explicit continuation rule ('When it returns... go straight to assembly without pausing'). Validation gates are explicit: the counterfactual precondition ('If the counterfactual fails, write nothing and report why'), frontmatter/claims validation, and the refresh check. Error-recovery and no-op paths are defined, matching the 5 anchor. | 5 / 5 |
Progressive Disclosure | The body is a true overview that routes to one-level-deep, well-signaled references, all of which exist in the bundle (research.md, modes.md, session-history.md, assembly.md, refresh-and-discoverability.md, enhancement.md, report.md, lightweight.md), each flagged as a required read at its specific step. Scripts and the agents/ subdirectory stay out of the main flow until the relevant reference or step needs them. Not below 5: navigation is easy and nothing that belongs in a reference is inlined. | 5 / 5 |
Total | 19 / 20 Passed |