self-review
Originally fromlingzhi227/agent-research-skills
Installation
SKILL.md
Self-Review Skill
Check the user's own manuscript before submission and produce an actionable list of anticipated reviewer comments, each with a specific fix — not a written review.
Optional Flags
--fix: after the report, apply fixes for every issue withfixable_by_ai: true, editing the manuscript in place, then report a diff summary. Never fixfixable_by_ai: falseissues (missing data, design flaws). Maximum 2 fix-and-re-review iterations; if the score is still below threshold after the second, stop and report what remains as structural (inside/write-paperthis routes to Phase 7.4a Audit Recovery).--json: also emit the structured JSON block (Phase 3c). Default when called from/write-paperPhase 7.--panel: run the multi-agent panel review (Phase 2.6) — domain-expert reviewers in parallel plus an editor synthesis — instead of the single-pass review. Opt-in and off by default, because it spawns N reviewer agents + 1 editor and costs several times more tokens; reserve it for a high-stakes final pass on a top-tier target. Do not combine with--fix: a panel diagnoses and prioritizes; run--fixas a separate pass once the author has triaged the panel's findings.
Severity Framing
- Fatal: a design flaw existing data cannot fix (data leakage that invalidates all results, no reference standard, label–feature circularity). Submission would likely be rejected. Reserve Fatal for true design-level problems.
- Fixable: significant but addressable with existing data (missing calibration, unclear exclusion criteria, absent CIs, incomplete reporting). Most issues are Fixable.