stata-skill

The most stable way to execute Stata commands, install ado packages, read help documents, and analyze data. Use when working with Stata for (1) Running do-fi...

Security Scan

The skill is an instruction-only wrapper for using the Stata-MCP CLI to run Stata workflows; its requirements and actions are broadly consistent with that purpose, with a minor metadata mismatch about required tools.

Purpose & Capability

The SKILL.md describes invoking the Stata-MCP CLI (uvx stata-mcp) to run do-files, install ado packages, read logs, and inspect data — this matches the declared purpose. However, the skill metadata lists no required binaries while the instructions explicitly state it requires 'uv' (uvx) and a valid Stata installation; the metadata omission is a mismatch that should be corrected.

Instruction Scope

Instructions stay within expected scope: they tell the agent to run specific uvx stata-mcp commands, inspect data files (.dta, .csv, .xlsx), and read execution logs. The doc notes a security guard blocks dangerous shell commands. There are no broad, vague directives to exfiltrate system data or read unrelated config paths.

Install Mechanism

No install spec is provided (instruction-only), which is low-risk. SKILL.md references external docs and a GitHub project (stata-mcp) and includes the sentence 'The skill could install or update from https://docs.statamcp.com/skills/openclaw' — this suggests an external install/update flow outside the registry metadata. If you follow those links to install code, review the sources before running downloads.

Credentials

The skill does not request environment variables, credentials, or config paths. Its runtime needs (access to local data files, logs, and the Stata executable) are proportional to its stated function.

Persistence & Privilege

always is false and model invocation is allowed (normal). The skill does not request persistent system privileges or to modify other skills. No indicators of elevated or permanent platform presence.

Assessment

This instruction-only skill looks coherent for controlling Stata via the Stata‑MCP CLI. Before installing/using it: (1) ensure you have uvx (uv) and a licensed Stata installed locally — the skill metadata should declare these but currently does not; (2) only install stata-mcp or follow external links (docs.statamcp.com, GitHub) after verifying the project/release integrity; (3) be aware the skill will operate on local data files and logs (it must be able to read/write them), so do not grant agent access to sensitive datasets unless you intend that; (4) if you rely on the claimed 'security guard', ask the skill author for details or tests showing which shell or destructive commands are blocked. If you want stricter assurance, request the author add explicit required-binaries metadata and an install spec that points to a verifiable release URL.

The skill could install or update from https://docs.statamcp.com/skills/openclaw

Stata-MCP is the best solution for connecting AI agents with Stata. It provides a suite of tools that allow Agents to execute Stata code through unified scheduling without wasting context searching for Stata executables. Both MCP and CLI interfaces are available. CLI is the preferred method for execution in this document.

CLI Tools (Fallback, mainly used by OpenClaw)

First, using uvx stata-mcp --usable to check whether Stata-MCP is usable. If there is any error, visit FAQ or commit an issue.

The following commands are supported:

uvx stata-mcp tool ado-install <package> [--source ssc|github|net]       # install ado-package from ssc, net or github
uvx stata-mcp tool do <dofile_path> [--log-file-name <name>]             # execute do-file
uvx stata-mcp tool help <command>          # Unix only                   # get command help
uvx stata-mcp tool data-info <data_path> [--vars-list var1 var2]         # get data basic information
uvx stata-mcp tool read-log <log_path> [--output-format full|core|dict]  # read execution log

Iterative Workflow

1. get_data_info -> understand dataset structure
2. Edit or Write -> to create a do-file
3. stata_do -> execute analysis with capture output
4. help -> learn Stata commands (Unix) if there are any command error
5. ado_package_install -> install missing packages

Notes

• Requires uv and valid Stata
• help only works on macOS/Linux
• Security guard blocks dangerous commands (shell, rm, etc.)
• Log location: <cwd>/stata-mcp-folder/stata-mcp-log/
• More information visit documents or GitHub