Content
100%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.
The body is a model skill document: lean, fully executable, with clearly sequenced workflows, ambiguity-resolution and validation checkpoints, and excellent progressive disclosure that pushes the large source-model data behind scripts instead of into context. No verbosity, no pseudocode, and every referenced path resolves to a real bundle file.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's competence: every line is a file path, command, or workflow step, with no explanation of concepts Claude already knows. It even enforces token discipline explicitly ('Do not inspect the full base.json in chat. Use the scripts so the large source model body stays out of context'). Not score 4 because there is no padding to trim — even the alias snippet and usageFactor notes are domain-specific facts Claude could not know. | 5 / 5 |
Actionability | All guidance is copy-paste executable: concrete 'node .opencode/skills/openwork-models/scripts/openwork-models.mjs search "z-ai/glm-5.1"' style commands cover every common case (search, add, remove, discount, sync, validate, trigger workflow), and the validation section gives exact commands to run before finishing. Not score 4 because the commands cover the common cases completely with real arguments, matching the anchor-5 example pattern. | 5 / 5 |
Workflow Clarity | Add/Remove/Discount workflows are clearly sequenced with ambiguity-resolution checkpoints (steps 2-3 of Add Workflow: ask the user, list matching IDs), scripts validate after each mutation, and the Validation section mandates running 'validate' and 'build-models.mjs' before finishing. The Update Models workflow includes explicit failure handling ('If the workflow or PR fails/closes unmerged, report that failure with the run/PR URL'). This satisfies the destructive/batch validation cap — validation and feedback loops are present — so it is not capped at 3 or reduced to 4. | 5 / 5 |
Progressive Disclosure | Scored against the actual bundle: all three scripts referenced in the body (extract-source-models.mjs, openwork-models.mjs, trigger-update-workflow.mjs) exist in ./scripts/, and the referenced subcommands (--query, search/add/remove/discount/sync/validate, --base/--ref) are real. The SKILL.md is a concise overview with heavy data (base.json) deliberately kept out of context behind scripts, and references are one level deep with no nesting. Not score 4 because there are no organization gaps — sections map cleanly to the workflows and the script surface. | 5 / 5 |
Total | 20 / 20 Passed |