# Skill Python Portability

> Audit and modernize Python scripts inside portable skills with PEP 723 dependency metadata, stable uv launchers, standard-library fallbacks, and no hidden virtualenv or global-package assumptions. Use when a skill invokes Python directly, has undeclared imports, fails outside its author’s machine, or needs contract-compliant bin and scripts structure.

- **Type:** Skill
- **Install:** `agentstack add skill-batteryshark-skill-tap-skill-python-portability`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [batteryshark](https://agentstack.voostack.com/s/batteryshark)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [batteryshark](https://github.com/batteryshark)
- **Source:** https://github.com/batteryshark/skill-tap/tree/main/skills/development/skill-development/skill-python-portability

## Install

```sh
agentstack add skill-batteryshark-skill-tap-skill-python-portability
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Improve Python Skill Portability

1. Run `bin/skill-python-portability SKILL_PATH` to inventory Python files, imports, PEP 723 blocks, and launcher coverage.
2. Read [references/python-portability.md](references/python-portability.md).
3. Present the audit before editing when dependency mapping or runtime support is ambiguous.
4. Add PEP 723 metadata to every runnable Python script, including an empty dependency list for standard-library-only tools.
5. Route the matching `bin/` launcher through `uv run --script`; fall back to `python3` only when dependencies are empty.
6. Run every changed command with realistic and failure fixtures, then run the tap validator.

Use [agents/python-portability-reviewer.md](agents/python-portability-reviewer.md) for an independent dependency and launcher review.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [batteryshark](https://github.com/batteryshark)
- **Source:** [batteryshark/skill-tap](https://github.com/batteryshark/skill-tap)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-batteryshark-skill-tap-skill-python-portability
- Seller: https://agentstack.voostack.com/s/batteryshark
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.