← LeaderboardThe Skill Leaderboard

stata-run

Run arbitrary Stata code or a .do file and display the result.

Published by brycewang-stanford ↗brycewang-stanford/Auto-Empirical-Research-Skills

Try your first task

stata-run

Start a fresh conversation. Replace the highlighted placeholders.

Use stata-run to run [Stata code or absolute .do-file path] and display its output; if it fails, report the error and return code.

Required inputs

  • [Stata code or absolute .do-file path]

User-approved starter prompt based on a pinned source version; check current skill requirements before running. Task evidence ↗

SKILL.md

name: stata-rundescription: Run arbitrary Stata code or a .do file and display the result.

The argument is the Stata code or absolute path to a .do file to execute.

  1. If the argument ends in .do or .ado, call:

    stata_run(code=<argument>, is_file=True, echo=True, as_json=True)

    Otherwise call:

    stata_run(code=<argument>, echo=True, as_json=True)

  2. If success is true, display the stdout output. Note the output is truncated to 5,000 chars; if the response includes a log_path, offer to tail the full log with /stata-log <log_path>.

  3. If success is false, display the error message and rc code. Suggest using /stata-lint <path> for syntax issues or /stata-help <command> for documentation.

  4. If the command produces graphs, note that /stata-graph can export them.

If using background mode (background=True): you may do other work or fire parallel tasks, but you MUST call stata_task_status(task_id=<id>, wait=True, timeout=<N>, tail_lines=<M>) for every task before returning to the user. Set timeout to match expected runtime; set tail_lines to how much output you want inline vs. reading separately via stata_read_log. Loop on timeout until status is 'done' or 'failed'.