Content
63%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 skill presents a coherent, well-sequenced 7-stage workflow with genuine validation at the end, and it respects token budget. Its weaknesses are executability and bundle integrity: stages are described rather than scripted, and the referenced `scripts/repo-audit.sh` (plus the mentioned `pr_todo.json`) do not exist in the bundle, leaving the automated core of the workflow unavailable.
Suggestions
Ship the actual `scripts/repo-audit.sh` in a scripts/ directory (or inline its grep/find checks) so Stage 2's referenced command is executable.
Add concrete commands for the vague stages — e.g. how to clone and baseline (git clone, git log --stat), how to search GitHub for competitors (gh search repos), and the exact gh commands for Stage 7's push and report.
Make the Stage 7 failure loop explicit: "If any check fails, return to Stage 6, fix, and re-run until 7/7 PASS before pushing."
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and well-sectioned, with each stage described in a few lines and no padded conceptual explanations. Minor over-explanation of things Claude already knows ("Don't commit `node_modules/` or `.env` files", "Use semantic commit messages: `chore:`, `fix:`, `docs:`") keeps it below the 5 anchor. | 4 / 5 |
Actionability | There is some concrete guidance (the named audit script, its six check categories, and example invocations), but most stages are directive summaries with no executable commands ("Clone the target repository, define success criteria"), and the core artifact `scripts/repo-audit.sh` does not exist in the bundle, so the central execution step cannot actually be run. Not a 2 because the script invocation and audit checks are more than high-level hints. | 3 / 5 |
Workflow Clarity | A clear 7-stage sequence with an explicit validation checkpoint (Stage 7: "Re-run the audit script (target: 7/7 PASS), verify all changes") and a P0/P1/P2 prioritization scheme, satisfying the validation requirement for destructive/batch operations. Not a 5 because the error-recovery loop (what to do when validation fails) is only implicit — it never says to return to Stage 6 and fix. | 4 / 5 |
Progressive Disclosure | Sections are well-organized for a skill of this size, but the body's only external file reference — "Run `scripts/repo-audit.sh`" — is a broken reference: no scripts/ directory (or any bundle files) exist, so the audit logic the whole workflow depends on is absent. This is worse than the 'references not clearly signaled' of the 3 anchor; it is not a 4 because a missing core dependency is more than a minor organization gap. | 3 / 5 |
Total | 14 / 20 Passed |