Mitwirkenden-Onboarding

Richtet ein Repository so ein, dass Erstbeitragende angelockt und gehalten werden: Erstellt CONTRIBUTING.md auf Basis echter Setup- und Testbefehle, generiert und validiert ein konsistentes GitHub-Label-Set (Typ, Status, Priorität, good first issue, help wanted) mit einem Dry-Run-Skript für gh und formt vage Issues in gut abgegrenzte Good-First-Issues um.

Was ist Mitwirkenden-Onboarding?

Dieses Skill automatisiert das Onboarding neuer Mitwirkender in einem Open-Source-Repository. Es generiert eine CONTRIBUTING.md direkt aus den tatsächlichen CI/CD-Befehlen und -Workflows des Projekts – Setup, Tests, Linting, Build – sodass die Anleitung immer zum echten Code passt. Der Skill erzeugt außerdem einen vollständigen GitHub-Label-Satz (Typ, Status, Priorität, Resolution, Dependencies) inklusive eines Prüf- und eines Shell-Skripts zum Anwenden, das vor der Ausführung eine Bestätigung verlangt, um versehentliche Änderungen zu vermeiden. Zuletzt hilft er dabei, vage Issues in strukturierte Good-First-Issues mit Kontext, Dateipfaden, Akzeptanzkriterien und Testanleitung umzuschreiben. Der Skill ist für Claude Code, Cursor, Codex und andere KI-Agenten geeignet, die auf GitHub-Repositories zugreifen können.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/saizul/oss-maintainer-skills/tree/HEAD/skills/contributor-onboarding

Installed? Explore more Produktivität & Zusammenarbeit skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht Mitwirkenden-Onboarding?

Neue Mitwirkende brauchen drei Dinge: einen Weg (CONTRIBUTING.md), eine Karte (Labels) und einen ersten Schritt (Good First Issues). Baue alle drei aus den echten Befehlen des Projekts.

Wann verwenden

  • „Schreibe eine CONTRIBUTING.md“ / „Wie bekomme ich Mitwirkende?“
  • Erstellen oder Bereinigen von GitHub-Labels
  • Schreiben von Good-First-Issues oder Vorbereitung auf Hacktoberfest oder einen Launch

Wann nicht verwenden

  • Governance-Dokumente für Stiftungen (GOVERNANCE.md, Chartas): außerhalb des Rahmens.
  • Verhaltenskodex-Text: übernimm den Contributor Covenant unverändert; schreibe ihn nicht um.

Ablauf

1. CONTRIBUTING.md

  1. Finde die echten Befehle: Setup (pip install -e ".[dev]", npm ci, composer install), Tests, Lint/Format, Build, Docs. Lese CI-Workflows; sie sind die Quelle der Wahrheit.
  2. Kopiere die Vorlage und fülle jeden Platzhalter aus. Führe jeden Befehl, den du dokumentierst, selbst aus oder sage klar, welche du nicht ausführen konntest.
  3. Halte es scannbar: Möglichkeiten zur Mitarbeit (nach benötigter Zeit), Setup, Tests, Stil, Commit-Konvention, PR-Prozess, Fragenort. Verlinke CODE_OF_CONDUCT.md und SECURITY.md.
  4. Füge 5–10 konkrete Einstiegsaufgaben unter „Good First Issues“ hinzu oder verlinke das Label.

2. Labels

scripts/ ist relativ zum Verzeichnis dieses Skills. Das Skript ruft nie GitHub selbst auf.

python3 scripts/labels.py generate > labels.json                  # Standard-Set
python3 scripts/labels.py generate --area cli --area docs --prefixed > labels.json
python3 scripts/labels.py validate labels.json                    # Exit 1 bei Problemen
python3 scripts/labels.py commands labels.json --repo OWNER/NAME > apply-labels.sh

Zeige dem Benutzer apply-labels.sh und frage vor der Ausführung: Es erstellt oder aktualisiert Labels auf GitHub (gh label create ... --force). Es löscht nie Labels. Wenn der Benutzer alte Labels entfernen möchte, liste sie mit gh label list auf und bestätige jede Löschung einzeln.

Behalte die GitHub-Namen good first issue und help wanted unverändert: GitHub und Drittanbieter-Seiten verwenden sie, um Anfängeraufgaben sichtbar zu machen.

3. Good First Issues

Schreibe Kandidaten-Issues mit dem Leitfaden um. Jedes benötigt: Kontext, die genauen zu bearbeitenden Dateien, Abnahmekriterien, eine Testanleitung und ein Angebot zur Hilfe. Frage vor dem Bearbeiten oder Labeln von Issues auf GitHub; biete den Text zuerst als Entwurf an.

Ausgabe

  • CONTRIBUTING.md (neu oder aktualisiert) und eine Liste der verifizierten vs. nicht verifizierten Befehle.
  • labels.json und apply-labels.sh (nicht ausgeführt, außer der Benutzer hat zugestimmt).
  • Entwürfe für Good-First-Issues als Markdown, bereit zum Einfügen oder zum Erstellen mit gh issue create --title ... --body-file ... --label "good first issue" nach Genehmigung.

Standard-Label-Set

GruppeLabels
Typbug, enhancement, documentation, question, performance, refactor
Mitwirkendegood first issue, help wanted
Statusneeds-triage, needs-repro, needs-info, confirmed, in-progress, blocked, stale
Prioritätpriority: critical, priority: high, priority: low
Lösungduplicate, invalid, wontfix
Abhängigkeitendependencies, security, breaking-change

--prefixed wechselt zu Namen im Stil type: bug, status: needs triage. GitHub begrenzt Label-Namen auf 50 Zeichen und Beschreibungen auf 100; validate prüft beides sowie 6-stellige Hex-Farben und case-insensitive Duplikate.

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

Verwandte Skills