Content
25%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.
This is a persona/role prompt, not an operational skill: it exhaustively enumerates capabilities and traits Claude already possesses while providing no commands, code, concrete review procedures, or working references. Almost every token could be deleted without reducing what Claude can actually do, and the one promise of deeper detail points to a nonexistent file.
Suggestions
Replace the Capabilities/Behavioral Traits/Knowledge Base catalogs with a small set of concrete, executable review procedures — e.g., actual Semgrep/CodeQL commands to run, a severity-ranked findings checklist, and a worked example of review feedback with code.
Fix or remove the dangling reference to `resources/implementation-playbook.md`; either create that file with the detailed playbooks and checklists, or inline the genuinely useful subset and cut the rest.
Rewrite the 'Response Approach' as a real workflow with validation checkpoints (e.g., 'run scanner → triage findings by severity → verify each claim against the diff before reporting') so the sequence has gates and an error-recovery loop instead of abstract labels.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is ~150 lines of padded persona content — 'Elite code review expert', 'Capabilities' lists of 100+ bullets (SonarQube, OWASP Top 10, N+1 detection, SOLID principles), 'Behavioral Traits', and a 'Knowledge Base' section — nearly all of which restates domain knowledge Claude already has. Individual bullets are terse, so it is not the worst-case explanatory prose of anchor 1, but the volume of zero-marginal-value content is severe: nothing here is knowledge Claude lacks. | 2 / 5 |
Actionability | Concrete tool names appear (SonarQube, CodeQL, Semgrep, npm audit, pip-audit), which is slightly more than minimal, but there is not a single command, code snippet, checklist, or specific step — instructions like 'Apply relevant best practices and validate outcomes' and 'Apply automated tools for initial analysis' are pure high-level hints with no executable path, and the only concrete pointer ('open resources/implementation-playbook.md') targets a file that does not exist in the bundle. | 2 / 5 |
Workflow Clarity | The 'Response Approach' offers a rough 10-step sequence ('Analyze code context', 'Apply automated tools', 'Conduct manual review'), but the steps are abstract labels with no commands or criteria, no validation checkpoints, and no error-recovery loop — matching anchor 2's 'rough sequence present but many gaps; validation absent' rather than anchor 3, whose steps are concrete and executable. | 2 / 5 |
Progressive Disclosure | Section headers exist, but the entire skill is one monolithic SKILL.md with no bundle files (no references/, scripts/, or assets/), and its single cross-file pointer, 'open `resources/implementation-playbook.md`', is dangling — the referenced file is absent, so navigation fails. That lands between anchor 2 (inlined content that belongs in separate files, broken/buried references) and anchor 3, and is noticeably below the midpoint. | 2 / 5 |
Total | 8 / 20 Passed |