Content
63%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 content is highly actionable with concrete reviewer prompts, executable commands, and explicit schemas, and the workflow is well-sequenced with validation gates. Its main weakness is token efficiency: significant redundant restatement of the same invariants and large inlined opt-in sections bloat what could be a much leaner file.
Suggestions
Consolidate the repeated invariants (fresh reviewer thread, REPLACE/REMOVE approval, always-emit-never-block, soft-only no-bib-mutation) into a single canonical statement in Key Rules and reference it elsewhere instead of restating each 3–5 times.
Move the detailed soft-only mode spec and the full JSON schema blocks into one-level-deep reference files (e.g. references/soft-only.md, references/artifact-schema.md), keeping only a short summary and link in SKILL.md.
Make the Step 7 validation loop explicit ("if Citation/Reference undefined warnings appear, fix the affected keys and re-run latexmk until clean") so the feedback loop matches the destructive/batch cap guidance.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | At ~500 lines the body restates the same invariants repeatedly — the fresh-reviewer-thread, REPLACE/REMOVE-approval, always-emit-never-block, and soft-only no-bib-mutation guarantees each appear 3–5 times across Constants, Key Rules, Workflow, and Submission Artifact Emission — which is noticeably verbose padding even though the content is accurate. | 2 / 5 |
Actionability | Provides a copy-paste Codex MCP reviewer prompt with model/config/sandbox, an executable `latexmk` recompile command, concrete JSON ledger examples (madaan2023selfrefine), and a full verdict decision table — fully executable guidance covering the common cases. | 5 / 5 |
Workflow Clarity | A clear 7-step sequence with explicit checkpoints (per-entry reviewer verdicts, aggregation decision table, interactive Step 6 approval gate, Step 7 recompile-and-verify), but the Step 7 validate→fix→retry loop is only implied ("Confirm: No new warnings") rather than explicitly stated, a minor validation gap. | 4 / 5 |
Progressive Disclosure | Good section structure and external protocols are delegated to shared-references files, but the file is monolithic with no bundle files present; large opt-in sections (soft-only ~120 lines, full JSON schemas, uncited detection) are inlined that could be split into one-level-deep reference files. | 3 / 5 |
Total | 14 / 20 Passed |