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 instruction-only skill body: concrete commands with validation checkpoints at every risky step, a well-sequenced five-phase workflow, and clean conditional routing to real, one-level-deep reference files. The only trimmable material is light editorial phrasing in the step headlines.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and operational — every step is a specific instruction or command with no explanations of concepts Claude already knows, fitting the 4 anchor (efficient, minor instances that could be trimmed). It falls short of 5 because of occasional editorial padding in step headlines and phrasing like "with verification, not guesswork", "only when it adds value", and "professionally", which add tone rather than executable information. | 4 / 5 |
Actionability | Guidance is fully executable with exact commands throughout: `apm install --dry-run`, `apm deps tree`, `apm compile --validate`, `apm preview <script> -p key=value`, `apm runtime setup <runtime>`, and a concrete copy-paste example `apm install webmaxru/agent-skills/skills/webmcp`. This matches the 5 anchor (copy-paste ready commands covering common cases); the only un-expanded command (installing the `apm` CLI itself) is a deliberate, minor delegation. | 5 / 5 |
Workflow Clarity | Five clearly sequenced steps (assess → shape manifest → manage dependencies → compile → operate) with explicit validation checkpoints for risky/batch operations: dry-runs before installs/uninstalls/prunes, verifying the lockfile `resolved_commit` actually changed after updates, `apm deps list/tree/info` verification, and `apm pack` only after a successful install. The Error Handling section plus named troubleshooting workflows ("Stale packages after update", "Self-referencing dependencies") provides feedback loops, matching the 5 anchor rather than 4. | 5 / 5 |
Progressive Disclosure | The SKILL.md body is a lean ~65-line overview that conditionally routes to real one-level-deep bundle files — `references/manifest-and-lockfile.md`, `references/command-workflows.md`, `references/troubleshooting.md` (with named sections verified to exist), and `assets/apm.yml.template` — each clearly signaled with a read-trigger condition ('If X, read Y before Z'). No nested references exist in the bundle, matching the 5 anchor for clear navigation and appropriate splitting. | 5 / 5 |
Total | 19 / 20 Passed |