Content
80%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-sequenced, highly actionable bring-up workflow with strong validation checkpoints and feedback loops. The major weakness is progressive disclosure: the skill cites flows/ and scripts/ paths that are absent from the bundle, so the referenced detailed material is unreachable.
Suggestions
Ship the referenced bundle: add a flows/README.md (and the flows/macros/ helpers and .ad snippets it describes) and a scripts/is-hybrid-app.sh, or remove the references and inline the essential guidance.
Verify 'Canonical skill references' and the bundled CLI skills dir pointer resolve at load time; document what to do if the npm-global path is absent rather than only checking it in pre-flight.
Tighten the 'Interaction safety' section by consolidating the repeated overlay/snapshot rationale into a single concise checklist.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient, command-driven, and assumes competence, but the 'Interaction safety' section is somewhat padded with repeated overlay/snapshot rationale; a few explanatory sentences could be trimmed without losing clarity. | 4 / 5 |
Actionability | Provides concrete, copy-paste-ready commands at every step (e.g. 'agent-device open <bundle-id> --platform <p> --device "<name>"', 'agent-device snapshot -i') with specific flags and bundle IDs, covering the common bring-up cases. | 5 / 5 |
Workflow Clarity | The Bring-up flow is a clearly numbered 9-step sequence with explicit STOP/validation checkpoints (pre-flight FAIL gates, dev-build check, Metro failure handling, sanity snapshot, overlay dismissal feedback loop), including error-recovery guidance. | 5 / 5 |
Progressive Disclosure | The body repeatedly points to flows/README.md and scripts/is-hybrid-app.sh, but no flows/ or scripts/ bundle directories exist in the skill; references resolve to nothing, leaving navigation broken and detail unsplit rather than well-disclosed. | 2 / 5 |
Total | 16 / 20 Passed |