onboarding-de-contribuidores

Configura um repositório para atrair e manter novos contribuidores – gera CONTRIBUTING.md a partir dos comandos reais do projeto, cria e valida um conjunto consistente de labels no GitHub (tipo, status, prioridade, good first issue, help wanted) com um script de simulação para gh, e transforma issues vagas em boas primeiras issues bem definidas.

O que é onboarding-de-contribuidores?

Esta skill automatiza três áreas essenciais para receber novos contribuidores em projetos open source: documentação de contribuição (CONTRIBUTING.md), organização de labels no GitHub e criação de boas primeiras issues. Ela analisa os workflows de CI para extrair os comandos reais de setup, testes e build, preenchendo um template de CONTRIBUTING.md com informações verificadas. Para labels, oferece um script Python que gera um conjunto padronizado (tipo, status, prioridade, etc.) e um script de simulação que mostra os comandos `gh label create` necessários, sem executá-los automaticamente. Por fim, ajuda a reescrever issues vagas em tarefas bem escopadas, com contexto, arquivos a modificar, critérios de aceitação e oferta de ajuda. É útil em qualquer momento em que o mantenedor queira aumentar a base de contribuidores, preparar o repositório para eventos como Hacktoberfest ou lançamentos, ou simplesmente organizar o fluxo de contribuição.

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

Installed? Explore more Produtividade e Colaboração skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Onboarding de contribuidores

Novos contribuidores precisam de três coisas: um caminho (CONTRIBUTING.md), um mapa (labels) e um primeiro passo (good first issues). Construa tudo isso a partir dos comandos reais do projeto.

Quando usar

  • "Escreva um CONTRIBUTING.md" / "como consigo contribuidores?"
  • Criar ou limpar labels no GitHub
  • Escrever boas primeiras issues, ou preparar para Hacktoberfest ou um lançamento

Quando não usar

  • Documentos de governança para fundações (GOVERNANCE.md, charters): fora do escopo.
  • Texto de código de conduta: adote o Contributor Covenant como está; não o reescreva.

Fluxo de trabalho

1. CONTRIBUTING.md

  1. Encontre os comandos reais: setup (pip install -e ".[dev]", npm ci, composer install), testes, lint/format, build, docs. Leia os workflows de CI; eles são a fonte da verdade.
  2. Copie o template e preencha cada espaço reservado. Execute cada comando que você documentar, ou diga claramente quais não conseguiu executar.
  3. Mantenha escaneável: formas de contribuir (por tempo necessário), setup, testes, estilo, convenção de commits, processo de PR, onde perguntar. Link para CODE_OF_CONDUCT.md e SECURITY.md.
  4. Adicione de 5 a 10 tarefas concretas para iniciantes sob "Boas primeiras issues" ou link para a label.

2. Labels

scripts/ é relativo ao diretório desta skill. O script nunca chama o GitHub diretamente.

python3 scripts/labels.py generate > labels.json                  # conjunto padrão
python3 scripts/labels.py generate --area cli --area docs --prefixed > labels.json
python3 scripts/labels.py validate labels.json                    # exit 1 se houver problemas
python3 scripts/labels.py commands labels.json --repo OWNER/NOME > apply-labels.sh

Mostre ao usuário o apply-labels.sh e peça permissão antes de executá-lo: ele cria ou atualiza labels no GitHub (gh label create ... --force). Ele nunca exclui labels. Se o usuário quiser remover labels antigas, liste-as com gh label list e confirme cada exclusão.

Mantenha os nomes good first issue e help wanted do GitHub inalterados: o GitHub e sites terceiros os usam para exibir tarefas para iniciantes.

3. Boas primeiras issues

Reescreva issues candidatas seguindo o guia. Cada uma precisa de: contexto, os arquivos exatos a modificar, critérios de aceitação, como testar e uma oferta de ajuda. Peça permissão antes de editar ou rotular issues no GitHub; ofereça o texto como rascunho primeiro.

Saída

  • CONTRIBUTING.md (novo ou atualizado) e uma lista de comandos verificados vs. não verificados.
  • labels.json e apply-labels.sh (não executados a menos que o usuário aprove).
  • Boas primeiras issues redigidas em Markdown, prontas para colar ou para criar com gh issue create --title ... --body-file ... --label "good first issue" após aprovação.

Conjunto padrão de labels

GrupoLabels
tipobug, enhancement, documentation, question, performance, refactor
contribuidorgood first issue, help wanted
statusneeds-triage, needs-repro, needs-info, confirmed, in-progress, blocked, stale
prioridadepriority: critical, priority: high, priority: low
resoluçãoduplicate, invalid, wontfix
dependênciasdependencies, security, breaking-change

--prefixed altera para nomes no estilo type: bug, status: needs triage. O GitHub limita nomes de labels a 50 caracteres e descrições a 100; validate verifica ambos, além de cores hexadecimais de 6 dígitos e duplicatas sem distinção entre maiúsculas e minúsculas.

Individual skills in this repo

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

Habilidades Relacionadas