Python Scripter

SkillFiles & storage

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.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the Python Scripter skill

What this skill tells your AI

The instructions your AI receives, as published by vaayne/agent-kit in skills/python-script/SKILL.md and read by ahel’s review.

Overview

Design and run Python scripts with clear requirements, safety checks, and reproducible logging.

Workflow

{project} is the git repo name (if in a git repo) or the basename of the current working directory.

  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/sessions/{project}/scripts/{script_name}.py.
  5. Run with uv run --script ~/.agents/sessions/{project}/scripts/{script_name}.py and monitor logs.
  6. Report results, risks encountered, and any follow-up steps.

Logging requirements

  • Log to ~/.agents/sessions/{project}/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

Signals

GitHub stars
53
Forks
4
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
python-script
Source
github.com/vaayne/agent-kit