contributor-onboarding

Configura un repositorio para atraer y retener nuevos contribuidores: escribe CONTRIBUTING.md a partir de los comandos reales del proyecto, genera y valida un conjunto consistente de etiquetas de GitHub (tipo, estado, prioridad, good first issue, help wanted) con un script dry-run para gh, y convierte issues vagos en good first issues bien definidos. Úsalo cuando el usuario quiera más contribuidores, solicite una guía CONTRIBUTING, etiquetas o good first issues, o se prepare para Hacktoberfest o un lanzamiento.

¿Qué es contributor-onboarding?

Esta skill automatiza tres pilares fundamentales para la incorporación de nuevos contribuidores en un repositorio de GitHub: una guía de contribución (CONTRIBUTING.md), un conjunto de etiquetas estandarizadas y una selección de buenos primeros issues (good first issues). Analiza los flujos de CI del proyecto para extraer los comandos reales de setup, pruebas, linting, construcción y documentación, y los refleja en una CONTRIBUTING.md generada a partir de una plantilla. Además, genera un archivo JSON de etiquetas usando un script Python (scripts/labels.py) que clasifica issues por tipo, estado, prioridad, resolución, dependencias y etiquetas de contribuidor, y produce un script Bash dry-run (apply-labels.sh) que el usuario debe revisar y aprobar antes de ejecutar. Finalmente, ayuda a reescribir issues vagos en good first issues detallados, con contexto, archivos exactos, criterios de aceptación y pasos para probar. Es compatible con cualquier repositorio de GitHub y está diseñada para usarse antes de eventos como Hacktoberfest o lanzamientos que busquen atraer contribuidores.

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

Installed? Explore more Productividad y colaboración skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Incorporación de contribuidores

Los nuevos contribuidores necesitan tres cosas: un camino (CONTRIBUTING.md), un mapa (etiquetas) y un primer paso (good first issues). Construye los tres a partir de los comandos reales del proyecto.

Cuándo usarla

  • "Escribe un CONTRIBUTING.md" / "¿cómo consigo contribuidores?"
  • Crear o limpiar etiquetas de GitHub
  • Escribir good first issues, o prepararse para Hacktoberfest o un lanzamiento

Cuándo no usarla

  • Documentos de gobierno para fundaciones (GOVERNANCE.md, charters): fuera de alcance.
  • Texto de código de conducta: adopta el Contributor Covenant tal cual; no lo reescribas.

Flujo de trabajo

1. CONTRIBUTING.md

  1. Encuentra los comandos reales: setup (pip install -e ".[dev]", npm ci, composer install), pruebas, lint/format, build, docs. Lee los flujos de CI; son la fuente de verdad.
  2. Copia la plantilla y rellena cada marcador de posición. Ejecuta cada comando que documentes, o di claramente cuáles no pudiste ejecutar.
  3. Mantenlo escaneable: formas de contribuir (por tiempo necesario), setup, pruebas, estilo, convención de commits, proceso de PR, dónde preguntar. Enlaza CODE_OF_CONDUCT.md y SECURITY.md.
  4. Añade de 5 a 10 tareas concretas para principiantes bajo "Good first issues" o enlaza la etiqueta.

2. Etiquetas

scripts/ es relativo al directorio de esta skill. El script nunca llama a GitHub en sí.

python3 scripts/labels.py generate > labels.json                  # conjunto por defecto
python3 scripts/labels.py generate --area cli --area docs --prefixed > labels.json
python3 scripts/labels.py validate labels.json                    # termina con 1 si hay problemas
python3 scripts/labels.py commands labels.json --repo OWNER/NOMBRE > apply-labels.sh

Muestra al usuario apply-labels.sh y pregunta antes de ejecutarlo: crea o actualiza etiquetas en GitHub (gh label create ... --force). Nunca elimina etiquetas. Si el usuario quiere eliminar etiquetas antiguas, listalas con gh label list y confirma cada eliminación.

Mantén los nombres de GitHub good first issue y help wanted sin cambios: GitHub y sitios de terceros los usan para mostrar tareas para principiantes.

3. Good first issues

Reescribe issues candidatos siguiendo la guía. Cada uno necesita: contexto, los archivos exactos a tocar, criterios de aceptación, cómo probar y una oferta de ayuda. Pregunta antes de editar o etiquetar issues en GitHub; ofrece el texto como borrador primero.

Salida

  • CONTRIBUTING.md (nuevo o actualizado) y una lista de comandos verificados vs. no verificados.
  • labels.json y apply-labels.sh (no ejecutados a menos que el usuario lo apruebe).
  • Good first issues redactados en Markdown, listos para pegar o para crear con gh issue create --title ... --body-file ... --label "good first issue" tras la aprobación.

Conjunto de etiquetas por defecto

GrupoEtiquetas
typebug, enhancement, documentation, question, performance, refactor
contributorgood first issue, help wanted
statusneeds-triage, needs-repro, needs-info, confirmed, in-progress, blocked, stale
prioritypriority: critical, priority: high, priority: low
resolutionduplicate, invalid, wontfix
dependenciesdependencies, security, breaking-change

--prefixed cambia a nombres de estilo type: bug, status: needs triage. GitHub limita los nombres de etiquetas a 50 caracteres y las descripciones a 100; validate verifica ambos, además de colores hexadecimales de 6 dígitos y duplicados sin distinción de mayúsculas/minúsculas.

Individual skills in this repo

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

Skills relacionados