Content
72%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is highly actionable with executable commands and clean progressive disclosure to real reference files. Its main weaknesses are duplicated command listings and a workflow that omits explicit validation checkpoints for destructive operations.
Suggestions
Merge the prose command summary and the Commands code block into a single listing to remove redundancy and improve token efficiency.
Add explicit validation/verification steps to the Workflow (e.g., confirm the cache file was written, check that the tmux server started, verify the checkpoint commit succeeded) with a fix-and-retry loop for failures.
Note the known failure/cleanup behavior (e.g., init removes partial state on failure) inline so Claude can recover without reading the full CLI contract.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient and assumes Claude's competence (no concept explanations), but the command set is listed twice — once as prose summaries and again as full invocations in the Commands block — which could be tightened into one combined listing. | 2 / 3 |
Actionability | The Commands block gives fully executable, copy-paste-ready invocations with all flags and placeholders (e.g. '"<skill-root>/bin/ii-app" web init <template_id> --project-name <name> --workspace <dir>'), and the Useful flags section documents concrete flag behaviors. | 3 / 3 |
Workflow Clarity | The four-step Workflow is sequenced, but it lacks explicit validation/verification checkpoints and feedback loops, and several operations (web init failing on existing dirs, checkpoint git commits, stripe webhook secret writes) are destructive or batch-like — capping this at 2 per the rubric. | 2 / 3 |
Progressive Disclosure | Content is well sectioned and points to two real, one-level-deep reference files (references/template-ids.md and references/cli-contract.md, both present) with clear 'For X, read Y' signaling, keeping detailed material out of the overview. | 3 / 3 |
Total | 10 / 12 Passed |