Content
96%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 operational skill: fully executable commands with explicit assertions, a clearly sequenced workflow with validation checkpoints, bounded retry logic, and a lean token budget with no padding. The only structural improvement is splitting detailed suite assertions or known-issues content into reference files to slim the always-loaded SKILL.md.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and operational throughout: exact CLI invocations with JSON payloads, terse 'Assert:' lines, and no explanations of concepts Claude already knows. Sections like 'Known Issues & Workarounds' carry non-obvious, project-specific facts ('PhysicsManipulation is automatically removed after forces are applied in a single frame'), so every token earns its place. A 4 would require some over-explanation to trim, which is absent. | 5 / 5 |
Actionability | Every instruction is a copy-paste-ready command such as `npx @iwsdk/cli ecs step --input-json '{"count":50}'`, with explicit assertions on the expected JSON output fields (e.g. 'state: "DYNAMIC"', '_engineBody: > 0'). Placeholders like <sphere> are defined in the setup step ('Save the entity named Dynamic Sphere as <sphere>'), and edge cases (SKIP for no static body) are handled. This matches the fully-executable anchor. | 5 / 5 |
Workflow Clarity | A five-step sequence (install, dev server, connectivity check, suites, cleanup) with explicit validation checkpoints: connectivity failure branches to 'report FAIL for all suites and skip to Step 5', each test has 'Assert:' lines, and a Recovery section provides a validate-restart-retry feedback loop bounded by 'Only give up after one retry attempt per suite.' This matches the anchor with explicit validation steps and error-recovery feedback loops. | 5 / 5 |
Progressive Disclosure | No bundle files (references/, scripts/, assets/) exist; the entire skill is a single ~300-line SKILL.md. It is well-sectioned with clear headers (per-suite '### Suite N' sections, Recovery, Known Issues), so navigation is easy and there are no nested or buried references — above the 'some structure' anchor of 3. It falls short of 5 only because content that could live in separate reference files (e.g., the detailed component-registration assertions in Suite 4 and the Known Issues section) is inlined in the main file. | 4 / 5 |
Total | 19 / 20 Passed |