skills.rest
agentculture
agentcultureOFFICIAL
Explore all skills by this author →
WebsiteGitHub

pypi-maintainer

Switches PyPI package installs between production, TestPyPI and local editable checkout via uv tool install.

112|6|Updated Mar 19, 2026
Search Tags:#dependency management#uv#pypi#testpypi#package promotion#editable checkout#prerelease pinning
One-click install
npx skills add https://github.com/agentculture/culture --skill pypi-maintainer
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: pypi-maintainer
Source: https://github.com/agentculture/culture/tree/main/.claude/skills/pypi-maintainer
Command: npx skills add https://github.com/agentculture/culture --skill pypi-maintainer

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires uv, bash, awk, and includes scripts (resource) components.

What problem does it solve?

It solves the problem of needing to quickly verify a package against a TestPyPI dev build before promoting the same dependency to production, without manually editing config files or guessing which version is installed.

Core Features & Use Cases

  • Switch between install sources: Toggle a package’s installation target among production PyPI, TestPyPI (with prerelease/dev builds), or a local editable checkout.
  • Supports prerelease/version pinning: Lets you pin TestPyPI to a specific dev version so you can reproduce the exact build from a PR or issue report.
  • Works for any AgentCulture PyPI sibling: Use the same mechanism across different maintained packages by passing the package name as an argument.

Quick Start

Ask the AI to run the command below to install a specific package from TestPyPI dev builds: "Switch the installation source for steward-cli to TestPyPI version 0.4.0.dev42."

Frequently Asked Questions about pypi-maintainer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I switch a PyPI package install to TestPyPI for testing a dev build?▼

To switch a PyPI package install to TestPyPI, use uv tool install with TestPyPI index configuration and enable unsafe-best-match plus prerelease allow to install the specific dev build for validation workflows.

Can I pin a specific prerelease version when installing from TestPyPI?▼

Yes, you can pin a specific prerelease version from TestPyPI by passing the exact dev version number, allowing you to reproduce the exact build from a pull request or issue report during validation.

Does uv work with editable checkouts for local package hot-patching?▼

Yes, uv supports local editable checkouts by enforcing editable mode from a pyproject.toml path, enabling you to apply local hot-patches and validate code changes before promoting the package.

What's the best way to restore a production PyPI install after testing a TestPyPI build?▼

The best way to restore a production PyPI install is to toggle the package installation target back to production PyPI, ensuring the stable published version replaces the TestPyPI or local editable build.

Why does my TestPyPI package install fail without prerelease allow in uv?▼

TestPyPI installs fail without prerelease allow because dev builds are prereleases; uv requires the prerelease allow flag combined with unsafe-best-match to correctly select and install the TestPyPI index version.

Related Skills

Explore More Software Engineering Skills→
nishide-devnishide-dev

tool-uv-monorepo

Configure uv workspaces for Python monorepos with a unified dependency graph.

Community
Advanced
kreuzberg-devkreuzberg-dev
836

test-apps-published-package-validation

Validate published packages across npm, PyPI, RubyGems, Maven Central, Docker Hub, and Homebrew.

Official
Intermediate
89jobrien89jobrien
4

python-scripting

Create standalone Python scripts with PEP 723 inline dependencies and uv execution.

Community
Advanced
Weihong-LiuWeihong-Liu

github-release-watch

Monitor GitHub repositories for new releases and generate Markdown summaries.

Community
Intermediate