v1.0.0

python-package-development v1.0.0

A Claude Code plugin for building Python packages the right way — R-inspired philosophy translated to modern Python tooling.

What's included

• 14 reference docs covering scaffold, API design, testing (basics + mocking + snapshots), docs, lifecycle, release, common mistakes, pre-commit, CLI, monorepo, automated release, and FAQ
• Example package — complete reference implementation passing 22/22 convention checks
• Convention auditor — check-structure.py script with 22 automated checks (runs via shell injection when you use /python-package-development check)
• Token budget checker — keeps the skill within Claude Code size limits
• CI workflow — token budget + example audit on PRs

Install

/plugin marketplace add Naareman/python-package-development
/plugin install python-package-development@python-package-development

Philosophy

Five principles from R's package ecosystem, applied to Python:

1. User communication is a first-class concern (rich)
2. Function names form a grammar (verb_noun())
3. Lifecycle deserves ceremony (deprecation warnings)
4. Documentation lives next to code (Google docstrings + mkdocs)
5. There is a whole game (scaffold first, refine later)

Companion tool

packright — CLI tool that automates these conventions (packright scaffold my-app).