mcpField
B
building-python-communities

building-python-communities

github.com/wdm0006Development10993 installsUpdated 2d ago
Repository

About building-python-communities

A community-management skill for Python library maintainers, covering contribution workflows, governance, and GitHub collaboration templates.

Key features

  1. 01Contribution and conduct templates
  2. 02Bug and feature request templates
  3. 03Pull request template and checklist
  4. 04GitHub Actions welcome automation
  5. 05Labels and governance guidance

Use cases

  1. 01Set up contribution workflows for a Python library
  2. 02Organize issue and pull request templates
  3. 03Plan ways for newcomers to contribute

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/wdm0006/python-skills --skill building-python-communities

After installing, type/building-python-communitiesin Claude Code to confirm it loaded.

Bundled filesGOVERNANCE.mdTEMPLATES.md

Details

From the project README

Python Library Community Management

Essential Files

CONTRIBUTING.md
# Contributing

## Development Setup

git clone https://github.com/user/package.git
cd package
uv sync --extra dev
pre-commit install
pytest

## Making Changes

1. Create a branch: `git checkout -b feature/name`
2. Make changes, add tests
3. Run: `make test && make lint`
4. Commit and open a PR

## Commit Messages

- `Add:` new feature
- `Fix:` bug fix
- `Update:` enhancement
- `Docs:` documentation
CODE_OF_CONDUCT.md

Use Contributor Covenant - the standard for open source.

Issue Templates

.github/ISSUE_TEMPLATE/bug_report.md:

---
name: Bug Report
labels: 'bug'
---
## Description
## To Reproduce
## Expected vs Actual Behavior
## Environment (OS, Python version, package version)
## Minimal Reproducible Example

.github/ISSUE_TEMPLATE/feature_request.md:

---
name: Feature Request
labels: 'enhancement'
---
## Problem Statement
## Proposed Solution
## Example Usage

PR Template

.github/PULL_REQUEST_TEMPLATE.md:

## Description
## Related Issue (Fixes #)
## Checklist
- [ ] Tests added
- [ ] Documentation updated
- [ ] CHANGELOG entry added

GitHub Actions Automation

# .github/workflows/welcome.yml
on:
  pull_request_target:
    types: [opened]
jobs:
  welcome:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/first-interaction@v1
        with:
          pr-message: "Thanks for your first PR! 🎉"

Labels

  • good first issue - Newcomer-friendly
  • help wanted - Extra attention needed
  • bug, enhancement, documentation

For detailed templates, see:

Checklist

Initial Setup:
- [ ] CONTRIBUTING.md
- [ ] CODE_OF_CONDUCT.md
- [ ] Issue templates
- [ ] PR template
- [ ] Labels defined

Ongoing:
- [ ] Respond to issues within 48h
- [ ] Review PRs within 1 week
- [ ] Maintain good first issues
- [ ] Recognize contributors

Learn More

This skill is based on the Maintenance section of the Guide to Developing High-Quality Python Libraries by Will McGinnis. See these posts for deeper coverage:

Comments

Markdown supported