Content
73%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-sequenced, highly actionable audit methodology with excellent error handling and report specification, scoring at the top of workflow clarity. Its critical defect is that all detailed detection heuristics and remediation profiles are delegated to a dozen reference files that do not exist in the bundle, making Step 4 ('read the referenced file and apply its detection heuristic') unexecutable as shipped; minor trimming (duplicated intro and trailing references section) would improve conciseness.
Suggestions
Ship the references/ directory with the twelve referenced files (foundations.md, cross-file-resolution.md, action-profiles.md, and vector-a through vector-i), or inline the per-vector detection heuristics into SKILL.md — as delivered, Step 4 and the remediation lookup in 5a instruct Claude to read files that do not exist.
Remove the trailing 'Detailed References' section (it duplicates the Step 4 table's reference column and the Step 5a remediation pointer) and tighten the opening paragraph, which restates the frontmatter description.
If the skill is intentionally distributed without the bundle, add a fallback section specifying what to do when a referenced file is absent (e.g., apply the inline quick-check column only and note the limitation in the report).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with non-obvious domain knowledge (rationalizations to reject, vector quick-checks, per-action field tables, exact gh api commands) and largely avoids explaining basics Claude already knows. Minor trimming opportunities keep it below 5: the intro paragraph restates the description almost verbatim, and the trailing 'Detailed References' section repeats references already given inline in the Step 4 table and Step 5a. | 4 / 5 |
Actionability | Highly concrete: copy-paste-ready `gh api` commands, exact URL-parsing rules, prefix-matching rules for `uses:`, per-action security field lists, and fully specified report formats. It falls short of 5 because the actual per-vector detection heuristics and remediation details are delegated to reference files that are not present in the bundle, so the body alone cannot fully execute Steps 4 and 5. | 4 / 5 |
Workflow Clarity | Steps 0-5 are explicitly sequenced ('Follow these steps in order. Each step builds on the previous one.') with clear stop conditions ('report... and stop the audit'), explicit error-handling branches for 401/404/empty directories, per-step count reporting as checkpoints, and a fully specified output layout including clean-repo and remote-analysis variants. This is a read-only audit, so the destructive/batch validation cap does not apply. | 5 / 5 |
Progressive Disclosure | The body is well structured for disclosure — one level deep, each reference clearly signaled with its purpose (e.g. 'see {baseDir}/references/cross-file-resolution.md for...') — but every referenced bundle file (foundations.md, cross-file-resolution.md, action-profiles.md, the nine vector files) is missing: the skill contains no references/ directory at all. Navigation to the core detection heuristics fails entirely, which is worse than the 'references present but not clearly signaled' case at 3 and lands at the 'navigation fails' end of the scale. | 2 / 5 |
Total | 15 / 20 Passed |