Help us improve
Share bugs, ideas, or general feedback.
From leandrocfe-skills
Scaffolds per-repo skill configuration: sets issue tracker origin (GitHub/GitLab/markdown local), canonical triage labels, and domain doc layout for use by engineering skills.
npx claudepluginhub leandrocfe/skillsHow this skill is triggered — by the user, by Claude, or both
Slash command
/leandrocfe-skills:setup-leandrocfe-skillsThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Scaffold da configuração por-repo que as engineering skills assumem:
Scaffolds per-repo configuration for engineering skills: issue tracker (GitHub/GitLab/local), triage labels, and domain doc layout.
Configures issue tracker (GitHub/GitLab/local markdown), triage labels, and domain docs for Matt Pocock's engineering skills. Run before using to-issues, triage, to-prd, etc.
Scaffolds per-repository agent context files including issue tracker rules, triage labels, domain glossary, ADR layout, and handoff conventions. Use when a repo needs durable agent context before planning, triage, or multi-agent work.
Share bugs, ideas, or general feedback.
Scaffold da configuração por-repo que as engineering skills assumem:
CONTEXT.md e ADRs vivem, e as regras de consumidor para lê-losEsta é uma skill prompt-driven, não um script determinístico. Explore, apresente o que achou, confirme com o usuário, depois escreva.
Olhe o repo atual para entender o estado inicial. Leia o que existe; não assuma:
git remote -v e .git/config — é um repo GitHub? Qual?AGENTS.md e CLAUDE.md na raiz do repo — algum existe? Já há uma seção ## Agent skills em algum?CONTEXT.md e CONTEXT-MAP.md na raiz do repodocs/adr/ e quaisquer diretórios src/*/docs/adr/docs/agents/ — output anterior desta skill já existe?.scratch/ — sinal de que uma convenção de issue tracker em markdown local já está em usoResuma o que está presente e o que falta. Depois caminhe com o usuário pelas três decisões uma de cada vez — apresente uma seção, pegue a resposta do usuário, depois passe à próxima. Não jogue as três de uma vez.
Assuma que o usuário não sabe o que esses termos significam. Cada seção começa com um explainer curto (o que é, por que essas skills precisam, o que muda se ele escolher diferente). Depois mostre as escolhas e o default.
Seção A — Issue tracker.
Explainer: O "issue tracker" é onde issues vivem para este repo. Skills como
to-issues,triage,to-prdeqaleem e escrevem nele — precisam saber se chamamgh issue create, escrevem um markdown sob.scratch/ou seguem algum outro workflow que você descreve. Escolha o lugar onde você de fato rastreia trabalho deste repo.
Postura default: estas skills foram desenhadas para GitHub. Se um git remote aponta para GitHub, proponha. Se um git remote aponta para GitLab (gitlab.com ou host self-hosted), proponha GitLab. Senão (ou se o usuário preferir), ofereça:
gh)glab).scratch/<feature>/ neste repo (bom para projetos solo ou repos sem remote)Seção B — Vocabulário de triage labels.
Explainer: Quando a skill
triageprocessa uma issue recebida, ela a move por uma máquina-de-estado — precisa de avaliação, esperando reporter, pronta para AFK agent pegar, pronta para humano, ou wontfix. Para isso, precisa aplicar labels (ou equivalente no seu issue tracker) que batem com strings que você de fato configurou. Se seu repo já usa nomes diferentes de label (ex.:bug:triageem vez deneeds-triage), mapeie aqui para a skill aplicar as certas em vez de criar duplicatas.
As cinco roles canônicas:
needs-triage — mantenedor precisa avaliarneeds-info — esperando reporterready-for-agent — totalmente especificada, AFK-ready (um agent pode pegar sem contexto humano)ready-for-human — precisa de implementação humanawontfix — não vai ser feitaDefault: a string de cada role é igual ao nome. Pergunte ao usuário se quer sobrepor alguma. Se o issue tracker dele não tem labels existentes, os defaults servem.
Seção C — Docs de domínio.
Explainer: Algumas skills (
improve-codebase-architecture,diagnose,tdd) leem um arquivoCONTEXT.mdpara aprender a linguagem de domínio do projeto, edocs/adr/para decisões arquiteturais passadas. Precisam saber se o repo tem um contexto global único ou múltiplos (ex.: um monorepo com contextos separados frontend/backend) para procurar no lugar certo.
Confirme o layout:
CONTEXT.md + docs/adr/ na raiz do repo. Maioria dos repos é assim.CONTEXT-MAP.md na raiz apontando para arquivos CONTEXT.md por contexto (tipicamente um monorepo).Mostre ao usuário um rascunho de:
## Agent skills para adicionar a qualquer um entre CLAUDE.md / AGENTS.md que estiver sendo editado (veja step 4 para regras de seleção)docs/agents/issue-tracker.md, docs/agents/triage-labels.md, docs/agents/domain.mdDeixe ele editar antes de escrever.
Escolha o arquivo a editar:
CLAUDE.md existir, edite.AGENTS.md existir, edite.Nunca crie AGENTS.md quando CLAUDE.md já existe (ou vice-versa) — sempre edite o que já está lá.
Se um bloco ## Agent skills já existe no arquivo escolhido, atualize seu conteúdo in-place em vez de anexar duplicata. Não sobrescreva edits do usuário nas seções ao redor.
O bloco:
## Agent skills
### Issue tracker
[resumo de uma linha de onde issues são rastreadas]. Veja `docs/agents/issue-tracker.md`.
### Triage labels
[resumo de uma linha do vocabulário de labels]. Veja `docs/agents/triage-labels.md`.
### Domain docs
[resumo de uma linha do layout — "single-context" ou "multi-context"]. Veja `docs/agents/domain.md`.
Depois escreva os três docs files usando os templates seed nesta pasta de skill como ponto de partida:
Para issue trackers "other", escreva docs/agents/issue-tracker.md do zero usando a descrição do usuário.
Diga ao usuário que o setup está completo e quais engineering skills agora vão ler desses arquivos. Mencione que ele pode editar docs/agents/*.md direto depois — re-rodar esta skill só é necessário se ele quiser trocar de issue tracker ou recomeçar do zero.