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 content body is a tight, executable specification: complete invocation commands, a full parameter table, defined outputs, integration context, honest limitations, and a test command. It respects Claude's intelligence while adding only repo-specific knowledge, with nothing that should be split out to a reference file. One optional trim: the standalone-invocation examples could note they assume the repo root as cwd.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's competence — no concept explanations ('Purely mechanical — no AI/LLM' is a meaningful signal, not padding), a compact parameter table, and terse sections like 'Outputs' and 'Known Limitations'. Every section carries information Claude could not infer; it does not fall to 4 because there are no trimmable over-explanations. | 5 / 5 |
Actionability | Provides copy-paste-ready invocations ('pwsh -NoProfile -Command & ./.github/scripts/Find-RegressionRisks.ps1 -PRNumber 33908 -OutputDir /tmp/out') plus a complete parameter table with defaults, concrete output artifacts (result.txt, risks.json, content.md), and a runnable test command. The only template-style commands (BuildAndRunHostApp.ps1, dotnet test) belong to the downstream pipeline, not the skill's own execution, so they don't create gaps. | 5 / 5 |
Workflow Clarity | The five-step algorithm is explicitly numbered ('1. PR diff … 5. Compare') with three unambiguous outcome verdicts (REVERT/OVERLAP/CLEAN), and the invocation workflow is a single unambiguous action covered by executable examples and a Tests section for verification. Not a destructive or batch operation, so no validation cap applies. | 5 / 5 |
Progressive Disclosure | No bundle files exist and none are needed; all content is one level deep in this SKILL.md with clear section headers (How It Works, Standalone Invocation, Parameters, Outputs, Integration, Known Limitations, Tests) and no buried or nested references. Repo-external paths (e.g. .github/scripts/Find-RegressionRisks.ps1, maui-expert-reviewer.md) are well-signaled pointers to the target repository's own artifacts, not opaque indirection. | 5 / 5 |
Total | 20 / 20 Passed |