Content
62%Weight 40%Scale 1-3Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body excels at workflow sequencing and validation gates, but its actionable detail depends on stage files that are not in the bundle, and it carries verbosity plus inline content that would benefit from being split out. Progressive disclosure is undermined by references to absent files.
Suggestions
Bundle the referenced stage-specific files (stage-*.md, libexec/raptor-*, packages/exploit_feasibility) or move their essential per-stage steps inline so the skill is self-contained.
Move the detailed SMT/Z3 add-on section into a separate reference file and keep only a brief pointer plus the integration contract in SKILL.md.
Remove redundancy: drop the Purpose section (already in the frontmatter) and consolidate [REMIND] with the MUST-GATEs.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly operational and dense, but ~290 lines with redundancy — the Purpose section restates the frontmatter and [REMIND] repeats the MUST-GATEs, while the SMT add-on section is verbose inline. | 2 / 3 |
Actionability | Provides concrete libexec commands and an executable Python snippet, but the core per-stage actionable detail is deferred to 'stage-specific files' that are not present in the bundle, leaving key steps unspecified in this file. | 2 / 3 |
Workflow Clarity | Stages 0–F–1 are explicitly sequenced with X0/X/X1 phases, a flow diagram, schema validation after each write, and clear feedback loops (e.g. 'Fix any errors before proceeding'). | 3 / 3 |
Progressive Disclosure | No bundle files exist, yet the body references stage-*.md, libexec/raptor-*, and packages/exploit_feasibility paths that are not bundled; the detailed SMT add-on is inline rather than split into a reference file. | 2 / 3 |
Total | 9 / 12 Passed |