Content
38%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill provides a reasonable high-level framework for a 7-stage GitHub repo audit workflow, but it lacks the concrete, executable guidance needed to be actionable. The referenced scripts and files (repo-audit.sh, pr_todo.json) are not included in the bundle, making the skill incomplete. The workflow stages describe what to do conceptually but not how to do it, and destructive operations in Stage 6 lack adequate validation checkpoints.
Suggestions
Include the actual `scripts/repo-audit.sh` script content or provide it as a bundle file, since the entire workflow depends on it.
Add concrete, executable commands or code for each stage — e.g., specific `gh` CLI commands for cloning, searching competitors, creating PRs, and pushing changes.
Add explicit validation checkpoints between stages, especially before and after Stage 6's destructive operations (e.g., 'List files to be deleted and confirm before proceeding').
Move detailed stage instructions into separate referenced files (e.g., STAGES.md) and keep SKILL.md as a concise overview with clear navigation links.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill includes some unnecessary padding ('turning a messy repo into a clean, well-documented, production-ready project') and explains concepts Claude would understand (what secrets patterns look like, what node_modules is). The 'When to Use This Skill' section is somewhat redundant. However, it's not egregiously verbose. | 3 / 5 |
Actionability | The skill describes stages at a high level but provides almost no executable guidance. There's no actual code, no script contents, no concrete commands beyond mentioning `scripts/repo-audit.sh` and `gh` CLI. The examples show trigger phrases but not what Claude should actually do at each stage. The referenced `repo-audit.sh` script is never shown or included in the bundle. | 2 / 5 |
Workflow Clarity | The 7 stages provide a clear sequence, and Stage 7 includes a validation step (re-run audit, target 7/7 PASS). However, there are no explicit feedback loops for error recovery, no validation checkpoints between intermediate stages, and the destructive operations in Stage 6 (deleting files, fixing security issues) lack explicit verification steps before proceeding. The destructive nature of Stage 6 without intermediate validation should cap this at 3. | 3 / 5 |
Progressive Disclosure | No bundle files are provided despite references to `scripts/repo-audit.sh` and `pr_todo.json`. The skill references external scripts and files that don't exist in the bundle. All content is inlined in a single file with no clear pointers to supporting documentation. The stage descriptions are too thin to be self-contained yet don't reference detailed guides. | 2 / 5 |
Total | 10 / 20 Passed |