Content
70%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is a well-structured orchestration skill: clear sequenced workflow with validation feedback loops and clean one-level references to real bundle files. It is held back only by some redundant emphatic callouts and executable detail that is largely delegated to recipe files.
Suggestions
Collapse the 'VALIDATION AUTHORITY' and 'MANDATORY NEXT STEP' callouts into the existing Steps table (or inline one-line reminders) to remove restating of steps 6, 8, and 9.
Replace vague steps like 'Build the project and fix any errors' and 'See recipe' with the specific build command and a direct link to the relevant recipe errors.md.
Inline the 1-2 most common validation commands (e.g. `azd provision --preview`, `bicep build`, `terraform validate`) directly in step 3 rather than only naming them in the authority block.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient with no concept explanations Claude already knows, but the 'VALIDATION AUTHORITY' block restates steps 6/8 and the 'MANDATORY NEXT STEP' block restates step 9, adding emphasis padding. Not a 3 because of this genuine redundancy; not a 1 because the body is otherwise lean. | 2 / 3 |
Actionability | Concrete file paths, statuses, and named commands ('azd provision --preview, bicep build, terraform validate') appear, but most executable detail is deferred to recipes and some steps are vague ('Build the project and fix any errors', 'See recipe'). Not a 3 because guidance is not consistently copy-paste ready; not a 1 because key actions are specific. | 2 / 3 |
Workflow Clarity | A 9-step sequenced table with a prerequisite gate, explicit validation checkpoints, and a feedback loop ('If any validation failed, fix the issues and re-run azure-validate') for a destructive deployment operation. Not a 2 because checkpoints and error-recovery are explicit. | 3 / 3 |
Progressive Disclosure | Clear overview body with well-signaled one-level-deep references (global-rules.md, recipes/README.md, role-verification.md) that resolve to real bundle files, with detailed validation commands split into recipe subfolders. Not a 2 because navigation is explicit and references are single-level. | 3 / 3 |
Total | 10 / 12 Passed |