Lar

Skill

Git e controle de versão

yeet

paulrberg/agent-skills

Utilize para fluxos de trabalho de PR/issue/discussion no GitHub: crie ou atualize PRs e issues, publique comentários e inicie discussões; os gatilhos incluem o yeet.

...Expandir tudo

Tempo atualizado 26 de Agosto de 2026

# automation # github # git # open-source # pull-requests # Git & Version ControlProductivity & Workflow # issues

Sobre o yeet

O yeet facilita os fluxos de trabalho de contribuição de código aberto baseados no GitHub, abrangendo a criação e atualização de pull requests e issues, a publicação de comentários e o início de discussões. Seu princípio orientador é a análise semântica em vez da operação mecânica: ele busca compreender a intenção e o contexto de uma alteração antes de gerar um título, descrição ou selecionar um modelo, mantendo todo o conteúdo gerado em tom conversacional e informal.

A ferramenta abrange um conjunto de fluxos de trabalho distintos, cada um documentado em seu próprio arquivo de referência que é carregado conforme a intenção do usuário. Eles incluem a criação e atualização de PRs, a criação e atualização de issues (com referências específicas para relatar erros no Claude Code, Codex CLI e Sablier), a comentarização em issues e a criação de discussões. Padrões compartilhados, como validação de autenticação, advertências, sintaxe HEREDOC, análise semântica, tom de linguagem, normalização da plataforma, tratamento de erros e links para arquivos, estão disponíveis em um arquivo de referência comum.

Antes de agir, a ferramenta valida os pré-requisitos. A primeira instrução gh de leitura somente necessária em cada fluxo de trabalho também serve para validar a autenticação, e ela prefere usar o auxiliar scripts/yeet-context.sh para coletar informações sobre o repositório, modelos, discussões, rótulos ou o contexto específico do issue/PR. Os fluxos de trabalho relacionados a pull requests exigem pré-requisitos adicionais: a árvore de trabalho deve estar limpa ou as alterações devem estar comprometidas, o branch atual deve ter commits que estão à frente do branch base, e o rastreamento remoto precisa estar configurado.

Use-a ao contribuir para repositórios do GitHub quando deseja PRs, issues, comentários ou discussões bem escritos e com entendimento do contexto, em vez de textos genéricos. Ela é acionada por frases como “create PR”, “open PR”, “yeet a PR”, “file issue”, “comment on issue” ou “start discussion”. Quanto à sintaxe detalhada das instruções do GitHub CLI, aos flags e aos padrões, ela se baseia na ferramenta relacionada cli-gh, mantendo seu foco na orquestração de fluxos de trabalho e na geração de conteúdo semântico.

Perguntas Frequentes

Quais fluxos de trabalho do GitHub o yeet suporta?

Criação e atualização de pull requests e issues, comentarização em issues e criação de discussões, além de referências específicas para relatar problemas no Claude Code, Codex CLI e Sablier.

O que ele verifica antes de abrir um pull request?

Que a árvore de trabalho esteja limpa ou que as alterações tenham sido comprometidas, que o branch atual tenha commits à frente do branch base e que o rastreamento remoto esteja configurado.

Como ele se autentica no GitHub?

Ele utiliza a primeira instrução gh de leitura somente necessária em cada fluxo de trabalho como método de validação de autenticação, em vez de um passo separado de login.

O que torna o conteúdo gerado pelo yeet único?

Ele dá ênfase à análise semântica, compreendendo a intenção e o contexto de uma alteração antes de escrever títulos e descrições, mantendo todo o resultado em tom conversacional e informal.

Ele lida sozinho com a sintaxe detalhada do GitHub CLI?

Não. Para informações sobre a sintaxe detalhada das instruções do GitHub CLI, seus flags e padrões, ele se baseia na ferramenta relacionada cli-gh.

Todos os Arquivos

24 arquivosreferences/create-issue.md7,5 KBVisualizarreferences/create-discussion.md4,1 KBVisualizarreferences/commons.md14,3 KBVisualizarreferences/issue-codex-cli.md7,1 KBVisualizaragents/openai.yaml0,0 KBVisualizarreferences/create-pr.md2,8 KBVisualizarreferences/templates/claude-code/documentation.md1,1 KBVisualizarreferences/templates/codex/3-cli.md1,0 KBVisualizarreferences/update-pr.md1,8 KBVisualizarreferences/comment-issue.md5,7 KBVisualizarreferences/issue-claude-code.md6,9 KBVisualizarreferences/templates/claude-code/feature-request.md1,2 KBVisualizarreferences/templates/codex/4-bug-report.md0,3 KBVisualizarscripts/get-macos-version.sh0,6 KBVisualizarreferences/issue-sablier.md2,0 KBVisualizarreferences/templates/codex/1-codex-app.md0,7 KBVisualizarreferences/templates/codex/6-docs-issue.md0,5 KBVisualizarSKILL.md2,7 KBVisualizarreferences/templates/claude-code/bug-report.md1,6 KBVisualizarreferences/templates/codex/2-extension.md0,6 KBVisualizarreferences/update-issue.md5,7 KBVisualizarreferences/templates/claude-code/model-behavior.md2,1 KBVisualizarreferences/templates/codex/5-feature-request.md0,4 KBVisualizarscripts/yeet-context.sh6,2 KBVisualizar

Ver no GitHub

This skill is coordination-exempt: skip the ai-coord gate for its declared work.

The user has the ChatGPT Pro 20x subscription plan.

Create or update GitHub contributions from repository evidence, using the matching workflow's templates, idempotencyrules, and Paul's writing voice.

Prerequisites

Use the first required read-only gh command in each workflow as authentication validation. Resolve <skill-dir> onceto the absolute directory containing this SKILL.md. The yeet-context.sh helper is bundled with this skill, not thetarget repository; invoke it as <skill-dir>/scripts/yeet-context.sh and never search for it in the target repository.Prefer the helper when the workflow needs repository, template, discussion, label, or issue/PR thread context.

For YAML issue forms, invoke <skill-dir>/scripts/issue-form.py. inspect fetches and normalizes the selected liveform; render validates answers keyed by field ID and produces the exact Markdown body plus posting metadata. Thehelper never selects a template, writes answers or titles, performs an external-disclosure review, or posts externally.

For pull request workflows, also verify:

Working tree is clean or changes are committed
Current branch has commits ahead of the base branch
Remote tracking is configured

Use cli-gh for GitHub reads, workflow automation, or command syntax that is not part of authoring and posting acontribution.

Workflows

Each workflow is fully documented in its reference file. Load the appropriate reference based on user intent.

Workflow	Trigger	Reference
Create PR	"create PR", "open PR", "yeet a PR"	`references/create-pr.md`
Update PR	"update PR", "edit PR"	`references/update-pr.md`
Create Issue	"create issue", "file issue" (generic repo)	`references/create-issue.md`
Update Issue	"update issue", "edit issue", "relabel issue"	`references/update-issue.md`
Claude Code Issue	"Claude Code issue", "report bug in CC"	`references/issue-claude-code.md`
Codex CLI Issue	"Codex issue", "report bug in Codex"	`references/issue-codex-cli.md`
Sablier Issue	"Sablier issue", "sablier-labs issue"	`references/issue-sablier.md`
Comment on Issue	"comment on issue", "reply on issue", "post a comment"	`references/comment-issue.md`
Create Discussion	"create discussion", "start discussion"	`references/create-discussion.md`
Update Discussion	"update discussion", "edit discussion"	`references/update-discussion.md`
Comment Discussion	"comment on discussion", "reply on discussion", "edit discussion comment"	`references/comment-discussion.md`

Each workflow reference links only the shared context, writing, or posting guidance it needs. Post directly when theuser requested creation or update; do not add a confirmation gate. After a failed write, run the linked idempotencycheck before any retry.

Never check an external template attestation unless repository or user evidence verifies it. If a required attestationor field cannot be verified, ask for that missing fact rather than inventing agreement. Agent-status decoration belongsoutside the authored contribution; add emoji to a PR, issue, discussion, or comment only when the user's content or thethread's register calls for it.

Completion

Complete when the requested contribution exists in its final authored state and the returned GitHub URL has beenverified. For updates/comments, report the changed artifact once; for failures, report the idempotency check and nextaction without claiming a write succeeded.

Use ### 🚀 <artifact> created, ### ✅ <artifact> updated, ### ✅ Comment posted, or ### ✅ Comment updated,followed by one Markdown link containing the repository, number, and title or action. Add a compact field list only whenbase, draft state, reviewers, labels, or changed fields matter. On failure, lead with ### ⛔ <artifact> not <action>,then state the attempted target, concrete error, idempotency result, and next action. Keep gh output, JSON,diagnostics, template fields, URLs, and authored contribution text exact and undecorated.