Create robust Python automation with full logging and safety checks. Use when tasks need complex data processing, authenticated API work, conditional file operations, or error handling beyond simple shell commands.
python-script follows the SKILL.md standard. Use the install command to add it to your agent stack.
---
name: python-script
description: Create robust Python automation with full logging and safety checks. Use when tasks need complex data processing, authenticated API work, conditional file operations, or error handling beyond simple shell commands.
---
# Python Scripter
## Overview
Design and run Python scripts with clear requirements, safety checks, and reproducible logging.
## Workflow
1. Confirm inputs, outputs, constraints, and preferred libraries.
2. Identify risky operations and secure explicit approval.
3. Scaffold a script with PEP 723 metadata and structured logging.
4. Lint with `uvx ruff check --fix .agents/scripts/{script_name}.py`.
5. Run with `uv run --script .agents/scripts/{script_name}.py` and monitor logs.
6. Report results, risks encountered, and any follow-up steps.
## Logging requirements
- Log to `.agents/logs/{script_name}.log` and stream to console
- Capture start/end timestamps, parameters, file operations, and errors
- Add `RotatingFileHandler` if logs may grow large
## Template
Read `references/script-template.md` for the full script template.
## Safety practices
- Provide dry-run or rollback paths
- Validate external inputs and API responses
- Use temporary directories for intermediates
- Never run destructive steps without confirmation