Content
62%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 body delivers a highly actionable, well-sequenced pipeline with strong validation feedback loops — its strongest qualities. It is dragged down by noticeable verbosity (redundant reminder/rationale sections and inlined reference-grade detail) and a progressive-disclosure structure that promises stage files the bundle does not actually contain.
Suggestions
Move the SMT/Z3 add-on section and the sharding workflow into separate reference files, keeping only a short summary and a pointer in SKILL.md.
Delete the redundant "[REMIND] Critical Reminders" section and the "Rationale" preamble — both restate rules already given in GATE-1/5/6 and EXEC.
Either ship the referenced stage files (stage-e-feasibility.md, web-profile.md, stage-specific docs) in the bundle or remove/inline the pointers so navigation does not dead-end.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The 370-line body has several padded or redundant sections: "[REMIND] Critical Reminders" restates GATE-1/5/6, a "Rationale" paragraph explains generic model behavior, the ~50-line SMT/Z3 section details constraint forms and output schemas, and a "Notice" section adds no operational value. Not 1 — the majority of the content is non-obvious operational rule-making that earns its tokens. | 2 / 5 |
Actionability | Concrete executable guidance dominates: exact commands ("libexec/raptor-validate-schema --lint part-<x> <file>", "libexec/raptor-run-sandboxed --output-dir ... <cmd>"), exact provenance JSON stamps, exact status-mapping tables, and a full manual code example. Minor gaps: the "Automatic (via Stage E)" block is a comment-only placeholder, and stage-specific files are referenced without paths. | 4 / 5 |
Workflow Clarity | Eight stages are explicitly sequenced with a phase table (X0/X/X1), a flow diagram, per-stage schema validation, mandatory post-Write validation with fix-before-proceeding, and an error-recovery loop (quarantine, bounded re-dispatch, receipt-gated merges) with explicit validation checkpoints. This matches the top anchor including feedback loops and checklists. | 5 / 5 |
Progressive Disclosure | The bundle contains only SKILL.md, yet the body references stage-specific files, "web-profile.md", "stage-e-feasibility.md", and ".claude/commands/validate.md" that are not present in the skill, while reference-grade content (SMT constraint encoding, sharding rules, output formatting) is inlined. Not 4 — the split between overview and detail files is not realized; not 2 — the section structure, tables, and flow diagram do provide navigable organization. | 3 / 5 |
Total | 14 / 20 Passed |