# Python Playground

> Python Playground is an Agent Skill for testing & quality published in the pydantic/monty repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Run and test Python code in a dedicated playground directory. Use when you need to execute Python scripts, test code snippets, investigate CPython behavior, or experiment with Python without affecting the main codebase.

- Skill name: `python-playground`
- Category: [Testing & Quality](https://www.openparable.com/skill/testing-quality/1)
- Source: https://github.com/pydantic/monty/blob/HEAD/.claude/skills/python-playground/SKILL.md
- Repository: pydantic/monty (7,884 GitHub stars when collected)

## SKILL.md

# Python Playground

Run Python code in an isolated playground directory for testing and experimentation.

## Instructions

1. First, ensure the playground directory exists. If the `playground` directory doesn't already exist, run `mkdir playground`.
2. Use the Write tool to create the Python file at `playground/test.py`
3. Run with: `uv run playground/test.py` to test cpython behavior or `cargo run -- playground/test.py` to test monty behavior

IMPORTANT: Use separate tool calls for each step - do NOT chain commands with `&&`. This allows the pre-approved commands to work without prompting.

## Example workflow

Step 1 - Create directory if it doesn't already exist (Bash, already allowed):

```bash
mkdir playground
```

Step 2 - Write code (use Write tool, not cat):
Write to `playground/test.py`:

```python
def foo():
    raise ValueError('test')

foo()
```

Step 3 - Run script (Bash, already allowed):

```bash
uv run playground/test.py
```

## Guidelines

- The `playground/` directory is gitignored
- Use a different file name for each test you want to run, give the files recognizable names like `test_value_error.py`
- Use `uv run ...` to run scripts (uses project Python)
- Or, `cargo run -- ...` to run scripts using Monty
- Use Write tool for creating files (avoids permission prompts)
- Run mkdir and uv as separate commands (not chained)
- do NOT delete files from playground after you've finished testing

---

Source: https://www.openparable.com/skill/testing-quality/python-playground (OpenParable). Cite the canonical URL above.
