// Run the stata-reviewer agent on a do-file. Produces a structured code-review report covering reproducibility, logging, naming, magic numbers, table/figure quality, and conformance to project conventions.
Combine saved Stata estimates into publication-ready tables via esttab. Produces both .tex (for paper) and .csv (for audit) with consistent formatting.
Simulate a fresh-clone reproduction of the entire pipeline and diff the new outputs against the committed ones. Catches drift before paper submission or release.
End-to-end Stata analysis workflow — load, explore, clean, estimate, and produce publication-ready tables and figures with full logging.
Run a holistic narrative review on a Quarto report or Markdown document. Checks reader prerequisites, worked examples, notation clarity, structural arc, and pacing.
Render a Quarto report (Stata engine) to HTML / PDF / DOCX. Performs freshness check on included tables/figures, verifies the Stata Quarto engine, and validates numerical claims before rendering.
Apply the replication protocol to a paper. Inventory the replication package, record gold-standard targets with tolerances, translate the analysis to this project's Stata pipeline, and report a tolerance-by-tolerance comparison.
| name | review-stata |
| description | Run the stata-reviewer agent on a do-file. Produces a structured code-review report covering reproducibility, logging, naming, magic numbers, table/figure quality, and conformance to project conventions. |
| disable-model-invocation | true |
| argument-hint | [path/to/file.do] |
| allowed-tools | ["Read","Grep","Glob","Task"] |
Delegate to the stata-reviewer agent and report the findings.
Resolve target from $ARGUMENTS:
dofiles/**/*.dodofiles/**/*.do and ask the user which to reviewConfirm the file exists and is non-empty.
Invoke the agent:
Delegate to stata-reviewer:
"Review dofiles/<stage>/<file>.do.
Read the do-file, the most recent log at logs/<stage>_<file>.log (if it exists),
and follow stata-coding-conventions, stata-reproducibility-protocol, and quality-gates.
Produce the report in the standard format."
Receive the agent's report at quality_reports/<dofile>_stata_review.md.
Summarize for the user:
Offer to apply fixes for high-confidence single-line issues (per proofreading-protocol's propose-then-apply pattern). Never apply silently.
/review-stata dofiles/03_analysis/main_regression.do
→ Full review with score and issue list.
/review-stata main_regression
→ Searches dofiles/**/main_regression.do.
/review-stata (no argument)
→ Lists candidates and asks.
/run-stata first; the reviewer benefits from log context.stata-reviewer covers code quality, not econometric correctness. Use econometric-reviewer (or /devils-advocate) for that.stata-coding-conventions.md for project-specific overrides; the agent reads that rule./validate-log (claims) and the econometric-reviewer agent (specs).quality_reports/ and persists across sessions; re-running this skill overwrites the previous report for that file.