# Stata Run

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

- Skill: `brycewang-stanford/stata-run` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds add brycewang-stanford/stata-run`
- Raw SKILL.md: https://api.skillmd.com/api/skills/brycewang-stanford/stata-run/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: brycewang-stanford (https://skillmd.com/u/brycewang-stanford)
- Updated: 2026-08-19
- Page: https://skillmd.com/skills/brycewang-stanford/stata-run

---


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'`.