Content
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is a well-sequenced, actionable orchestration contract with explicit review gates and remediation feedback loops. Its main weaknesses are duplicated instructions that bloat the token budget and a monolithic structure with no progressive disclosure into reference files.
Suggestions
De-duplicate the .gitignore/.ignore instructions: state them once and reference back, rather than repeating the full block in both 'Core Contract' and 'Deepwork File'.
Consolidate the anti-micro-phase guidance so it appears once instead of being restated across 'Core Contract' and 'Planned Phase Reviews'.
Consider moving the 'Designer Handoff Guardrail' detail and the deepwork-file template guidance into reference files so SKILL.md reads as an overview with one-level-deep pointers.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The imperative bullet style is lean and assumes competence, but the .gitignore/.ignore instructions are duplicated across 'Core Contract' and 'Deepwork File', and the anti-micro-phase guidance is restated in 'Planned Phase Reviews'. | 2 / 3 |
Actionability | Guidance is concrete and copy-paste ready for an instruction skill: exact paths ('.slim/deepwork/'), literal gitignore entries, named agents (@oracle, @designer, @fixer, @librarian) with specific responsibilities. | 3 / 3 |
Workflow Clarity | The 'Required behavior' list is a clearly sequenced pipeline with explicit validation checkpoints (per-phase Oracle review gates, final validation) and a feedback loop (triage findings into one remediation pass, validate, conditionally re-review). | 3 / 3 |
Progressive Disclosure | Sections are well-headed, but the skill is a monolithic single-file contract with no overview-to-reference split; the designer guardrail and file-template detail are inline rather than factored into bundle files. | 2 / 3 |
Total | 10 / 12 Passed |