Content
75%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.
A well-built review skill: concrete commands, sharp forcing questions with example answers, a complete output template, and an explicit workflow with a tiered verdict. The main gaps are redundancy in command/routing mentions and externally-anchored script references with no stated usage.
Suggestions
State usage for the referenced scripts (arguments, expected output) or move them into the skill's scripts/ bundle so the commands are verifiably executable.
Deduplicate the cs-ciso-advisor handoff (Question 6, Workflow step 3, and Routing all repeat it) and drop the redundant standalone "Command:" line.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and question-driven with no padding explaining concepts Claude already knows, and includes genuinely useful concrete material (an example answer like "It breaks at 10× current load because the primary DB writes saturate", a full output template). Minor trims remain: the command name appears in the frontmatter, the H1, and a standalone "Command:" line, and cs-ciso-advisor routing is repeated in Question 6, the Workflow, and the Routing section — so not every token earns its place. | 4 / 5 |
Actionability | Two concrete bash commands (tech_debt_analyzer.py, team_scaling_calculator.py) and a copy-paste-ready output template make the guidance mostly executable, fitting the 4 anchor. It is below 5 because the referenced scripts live outside the skill bundle via deep relative paths (../../../c-level-advisor/...) and take no stated arguments or inputs, leaving minor gaps. | 4 / 5 |
Workflow Clarity | The Workflow section gives a clear four-step sequence (run analyzers → define scaling-cliff hypothesis → cross-check security → apply verdict), and the six questions plus the tiered 🟢/🟡/🔴 verdict act as a checklist with a decision checkpoint. It is not a destructive or batch operation so no 3-cap applies, but there is no explicit feedback/error-recovery loop (e.g. what to do when the break-point hypothesis cannot be confirmed), keeping it below the 5 anchor. | 4 / 5 |
Progressive Disclosure | Sections are well-organized (When to Run, Six Questions, Workflow, Output Format, Routing, Related) and external references (cs-cto-advisor agent, cto-advisor skill, slo-architect) are one level deep and clearly signaled with paths, matching the good-structure anchor. It falls short of 5 because the analyzer scripts are invoked via deep inline relative paths rather than a clean, clearly-labeled script layout, and the linked resources sit outside the skill bundle. | 4 / 5 |
Total | 16 / 20 Passed |