Stats
Actions
Tags
From python-library-distribution
Reviews Python libraries for quality across structure, packaging, code, testing, security, documentation, API design, and CI/CD. Use to evaluate library health, prepare releases, or audit dependencies.
How this skill is triggered — by the user, by Claude, or both
Slash command
/python-library-distribution:library-reviewThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
```bash
git clone https://github.com/user/package && cd package
cat pyproject.toml | head -50 # Modern config?
ls tests/ && pytest --collect-only # Tests exist?
pytest --cov=package | tail -20 # Coverage?
pip install bandit && bandit -r src/ # Security?
| Area | Check For |
|---|---|
| Structure | src/ layout, py.typed marker |
| Packaging | pyproject.toml (not setup.py) |
| Code | Type hints, docstrings, no anti-patterns |
| Tests | 80%+ coverage, edge cases |
| Security | No secrets, input validation, pip-audit clean |
| Docs | README, API docs, changelog |
| API | Consistent naming, sensible defaults |
| CI/CD | Tests on PR, multi-Python, security scans |
# Library Review: [package]
**Rating:** [Excellent/Good/Needs Work/Significant Issues]
## Strengths
- [Strength 1]
## Areas for Improvement
- [Issue 1] - Severity: High/Medium/Low
## Category Scores
| Category | Score |
|----------|-------|
| Structure | ⭐⭐⭐⭐⭐ |
| Testing | ⭐⭐⭐☆☆ |
| Security | ⭐⭐⭐⭐☆ |
## Recommendations
1. [High priority action]
2. [Medium priority action]
For detailed checklists, see:
Essential:
- [ ] pyproject.toml valid
- [ ] Tests exist and pass
- [ ] README has install/usage
- [ ] LICENSE present
- [ ] No hardcoded secrets
Important:
- [ ] Type hints on public API
- [ ] CI runs tests on PRs
- [ ] Coverage > 70%
- [ ] Changelog maintained
Recommended:
- [ ] src/ layout
- [ ] py.typed marker
- [ ] Security scanning in CI
- [ ] Contributing guide
This skill is based on the Guide to Developing High-Quality Python Libraries by Will McGinnis. The review criteria in this skill draw from all posts in the guide — see the full guide for detailed quality criteria across every dimension of library development.
npx claudepluginhub wdm0006/python-skills --plugin python-library-completeReviews and improves Python library code quality using ruff linting, mypy type checking, Pythonic refactoring idioms, and type hint patterns.
Guides design, architecture, and review of production-grade Python libraries: structure, API design, testing strategy, and implementation trade-offs.
Provides index of 12 principle skills for Python package creation, review, modernization including project structure, pyproject.toml, testing, CI/CD, docs, releases. Use when selecting skills or starting projects.