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.
An exemplary lean skill body: executable commands for all entry points, explicit behavioral policies (don't auto-install, don't probe, stop on missing CLI), a clear error-recovery path, and well-signaled deferred detail via version-matched help topics. The single gap is the absence of a concrete example interaction command after `open`, leaving the actual driving steps delegated to the tool's runtime output.
Suggestions
Include one short example of a follow-up interaction after `agent-device open` (e.g., a tap or assert command from the interactive snapshot) so the common driving loop is copy-paste ready without relying solely on the tool's runtime hints.
Briefly name the concrete evidence commands (screenshot/log capture) in the debugging entry point or as a one-line pointer, since 'collect failure evidence' is a stated capability but has no corresponding command in the body.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~30-line body is lean and assumes Claude's competence: it never explains what an emulator or the CLI is, and every sentence either gives a command or a policy ("Do not probe first with --help...", "Treat installation and upgrades as user-owned setup steps"). This matches the 'every token earns its place' anchor; there is no padding to trim for level 4. | 5 / 5 |
Actionability | Concrete, executable commands are given for every entry point — `npm install -g agent-device@latest`, `agent-device open <app-or-package-id> --platform android --foreground`, and five `agent-device help <topic>` commands. However, no example of an actual follow-up interaction command (tap/type/scroll after opening) is shown — that detail is delegated to the tool's "initial interactive snapshot and corrective error hints" — which is a minor gap fitting the 'mostly executable, concrete commands with minor gaps' anchor rather than the fully-covered level 5. | 4 / 5 |
Workflow Clarity | For a simple, single-purpose skill the flow is unambiguous and correctly ordered: require user-owned install → open with explicit platform flag → follow the interactive snapshot and corrective hints → on unavailability, stop and ask the user → consult version-matched help only for specialized tasks. There is an explicit error-recovery path ("If the shell reports that agent-device is unavailable, stop and ask the user") and a corrective feedback loop via the snapshot hints, so it exceeds the level-4 anchor with its minor validation gaps. | 5 / 5 |
Progressive Disclosure | No bundle files exist (references/, scripts/, assets/ are absent) and the body is under 50 lines, so per the rubric's simple-skill guideline well-organized short content can score 5. The only deferred content is one level deep and clearly signaled with a condition — "Only when the task is specialized or a command shape is unclear, read the relevant version-matched help topic" — with each topic annotated (e.g., "engineering validation and build freshness"). | 5 / 5 |
Total | 19 / 20 Passed |