Github

• Você quer que um agente monitore ou faça a triagem de issues e pull requests do GitHub em seu nome.
• Você precisa inspecionar o status de pipelines de CI/CD — listando execuções de workflows, visualizando logs de etapas com falha ou diagnosticando uma build quebrada.
• Você precisa de saída JSON estruturada do GitHub para processamento downstream ou geração de relatórios.
• Você quer consultar endpoints da API REST do GitHub que vão além do que os subcomandos padrão do gh expõem (por exemplo, buscar campos específicos de PR com filtros --jq).

• Você precisa interagir com o GitHub em nível de protocolo Git (clonagem, envio de commits, rebase) — esta skill é para a API da plataforma GitHub, não para operações Git brutas.
• Você precisa de um host GitLab, Bitbucket ou outro host que não seja GitHub; o CLI gh é exclusivo do GitHub.

Liste, visualize e verifique o status de pull requests com comandos como gh pr checks e gh pr list. Funciona com qualquer repositório especificando --repo owner/repo, mesmo fora de um diretório git.

Inspecione execuções de workflows do GitHub Actions com gh run list, gh run view e --log-failed para exibir apenas os logs das etapas com falha. Ideal para agentes que precisam diagnosticar pipelines quebrados sem precisar buscar logs manualmente.

O comando gh api desbloqueia qualquer endpoint da API REST do GitHub. Combine-o com filtros --jq para extrair exatamente os campos que você precisa — por exemplo, obtendo o título, o estado e o autor de um PR em uma única chamada.

A maioria dos subcomandos do gh suporta as flags --json para que as respostas possam ser redirecionadas para expressões --jq ou consumidas diretamente por ferramentas subsequentes. Isso torna simples para agentes analisar e agir sobre dados do Github de forma programática.

Liste e filtre issues com gh issue list, incluindo saída em JSON para consultas estruturadas. Suporta filtragem por labels, estado, responsável e mais, por meio das flags padrão do gh.

Um agente verifica todos os PRs abertos, busca o status de CI deles via gh pr checks e identifica os PRs que estão falhando ou parados — fornecendo ao desenvolvedor uma lista priorizada sem a necessidade de verificar o dashboard manualmente.

Quando uma build quebra, o agente executa gh run view <run-id> --log-failed para obter apenas os logs das etapas que falharam e resume a causa raiz, poupando os engenheiros de rolar por longas saídas de CI.

O agente consulta issues abertas com gh issue list --json e filtros --jq para gerar um relatório estruturado — agrupando por label, idade ou responsável — para um resumo semanal da equipe.

Usando gh api com consultas --jq personalizadas, um agente recupera metadados específicos (por exemplo, SHA do commit de merge de um PR, lista de revisores ou tempo de execução de workflows) que não são exibidos pelos subcomandos padrão.