python-toolkit

python-toolkit

Dispatch skill for Python development. Routes observable situations to the appropriate retained skill or bare CLI invocation.

Detection

Before routing, detect the project environment:

1. Check for pixi.toml in the current or parent directory → pixi mode
2. Check for pyproject.toml, requirements.txt, .venv/ → pip/venv mode
3. Check tool availability: ruff --version, ty --version, pixi --version

When You See This → Do This

Observable situation	Action	Notes
ruff output with [*] fixable with --fix	ruff check --fix <path>	Run first, review remaining; use --unsafe-fixes with caution
ty/pyright errors or type warnings in output	Invoke typecheck skill	Full report with context and error grouping
Both lint and type errors present	ruff check --fix then typecheck skill	Fix lint first, types second
Ambiguous or multi-source diagnostic output	Invoke diagnostic-review skill	Triages ruff + ty output together; auto-activates on mixed noise
Unknown ruff rule code (e.g. I001, PLR6201)	Invoke rule skill	Explains the rule with fix guidance
Many lint violations, need overview	Invoke stats skill	Ranked summary of violations by rule category
Code style inconsistencies after editing	ruff format <path>	Direct ruff invocation; no wrapper needed
Import blocks unsorted or messy	ruff check --fix <path>	I001 is auto-fixable

Project Management

Project management commands were culled in 4.0.0.0. Use bare CLI directly for these operations.

Situation	Action
User asks to add a package	pixi add <package> / pip install <package>
User asks to remove a package	pixi remove <package> / pip uninstall <package>
Dependencies out of sync	pixi install / pip install -r requirements.txt
No pyproject.toml or pixi.toml in directory	pixi init / uv init to bootstrap the project
User asks to run a task or script	pixi run <task> / python <script.py>
User asks about project or tool status	Invoke info skill
User asks to configure linting, types, or task runner	Invoke configure skill
User asks to build the Python package	pixi run build / python -m build
User asks to run tests, or test suite is failing	pixi run test / pytest <path>
User asks to list, add, or remove pixi tasks	pixi task add <name> / pixi task list
User asks to list, create, or remove environments	pixi environment list / pixi project environment add
pixi.lock is outdated or user asks to refresh it	pixi update
User needs a shell with the environment active	pixi shell

Grounding

When you encounter an unfamiliar ruff rule, ty error, or tool flag:

1. Use the rule skill for ruff rules
2. Use Context7 (if installed) to query ruff or ty documentation for specifics
3. If Context7 is unavailable, use web search for official docs
4. Do not guess what a rule or flag does — look it up

Fallback Guidance

• If ruff is not installed: advise pip install ruff or pixi global install ruff
• If ty is not installed: advise pip install ty or pixi global install ty
• If pixi is not installed and user wants pixi features: advise installation from https://pixi.sh
• If no Python project detected: run pixi init or uv init to create one