yeet
paulrberg/agent-skills
Create and update GitHub PRs, issues, and discussions with templated workflows and idempotency checks.
What is yeet?
A GitHub contribution automation skill for agents to create, update, and comment on pull requests, issues, and discussions. Use it when you need to manage GitHub workflows programmatically with built-in templates, writing voice consistency, and idempotency rules.
- Create pull requests with verification of clean working tree and commits ahead of base branch
- Create and update GitHub issues with YAML form support and template rendering
- Create and update discussions with templated content
- Post and edit comments on issues and discussions
- Apply idempotency checks before retrying failed writes
- Validate GitHub CLI authentication and repository context
How to install yeet
npx skills add https://github.com/paulrberg/agent-skills --skill yeet- Authenticated GitHub CLI >= 2.97.0
- cli-gh skill installed
- Clean working tree or committed changes (for PR workflows)
- Current branch with commits ahead of base branch (for PR workflows)
How to use yeet
- 1.Determine the workflow type based on user intent (create PR, update issue, comment discussion, etc.)
- 2.Load the appropriate reference file from the skill's references/ directory
- 3.Use yeet-context.sh helper to fetch repository, template, or thread context as needed
- 4.For YAML forms, use issue-form.py to inspect templates and render answers
- 5.Verify GitHub CLI authentication with a read-only gh command
- 6.Execute the workflow (create, update, or post) without confirmation gates
- 7.Verify the contribution exists in final state and readback the GitHub URL
Use cases
- Automating PR creation from code changes with consistent formatting and metadata
- Filing structured bug reports using repository issue templates
- Starting discussions with templated content and proper context
- Posting review comments or updates to existing issues and discussions
- Retrying failed contribution writes with idempotency verification
- AI agents managing GitHub workflows
- Development teams automating contribution creation
- Repository maintainers standardizing issue and PR formats
yeet FAQ
This skill skips the ai-coord gate for its declared work, allowing it to proceed directly with GitHub operations without coordination checks.
After a failed write, run the linked idempotency check before retrying. This prevents duplicate contributions and handles partial failures gracefully.
The skill uses repository-specific templates and Paul's writing voice. For YAML issue forms, use the issue-form.py helper to inspect and render them; never invent templates.
Use the first required read-only gh command in each workflow as authentication validation. If it fails, resolve authentication before proceeding.
All workflows apply references/context.md > Issue Metadata Permissions before resolving or passing metadata to ensure proper authorization.
Full instructions (SKILL.md)
Source of truth, from paulrberg/agent-skills.
argument-hint: <create-pr|update-pr|create-issue|update-issue|issue-claude-code|issue-codex-cli|issue-sablier|comment-issue|create-discussion|update-discussion|comment-discussion> [options] compatibility: Authenticated GitHub CLI >= 2.97.0 coordination: exempt effort: high name: yeet skill-dependencies:
- cli-gh description: "Use for GitHub PR/issue/discussion workflows: create/update PRs, issues, or discussions and post issue or discussion comments; triggers include yeet."
GitHub Contribution Workflows
This skill is coordination-exempt: skip the ai-coord gate for its declared work.
Create or update GitHub contributions from repository evidence, using the matching workflow's templates, idempotency rules, and Paul's writing voice.
Prerequisites
Use the first required read-only gh command in each workflow as authentication validation. Resolve <skill-dir> once
to the absolute directory containing this SKILL.md. The yeet-context.sh helper is bundled with this skill, not the
target 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 live
form; render validates answers keyed by field ID and produces the exact Markdown body plus posting metadata. The
helper never selects a template, writes answers or titles, performs an external-disclosure review, or posts externally.
All issue creation and update workflows apply references/context.md > Issue Metadata Permissions before resolving or
passing metadata. Rendered template metadata describes requested values, not the viewer's authority to apply them.
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 a
contribution.
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 the user requested creation or update; do not add a confirmation gate. After a failed write, run the linked idempotency check before any retry.
Never check an external template attestation unless repository or user evidence verifies it. If a required attestation or field cannot be verified, ask for that missing fact rather than inventing agreement. Agent-status decoration belongs outside the authored contribution; add emoji to a PR, issue, discussion, or comment only when the user's content or the thread's register calls for it.
Completion
Complete when the requested contribution exists in its final authored state and the returned GitHub URL has been verified. For updates/comments, report the changed artifact once. Determine the outcome from readback, not the command's exit status: creation can succeed before a metadata mutation fails.
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 when
base, draft state, reviewers, labels, or changed fields matter. For verified partial success, report the created or
updated artifact and identify omitted or failed metadata. Use ### ⛔ <artifact> not <action> only for confirmed
noncompletion; if readback is inconclusive, report the outcome as unverified. Include the concrete error, idempotency
result, and next action. Keep gh output, JSON, diagnostics, template fields, URLs, and authored contribution text
exact and undecorated.
Related skills
More from paulrberg/agent-skills and the wider catalog.

biome-js
Configure and extend BiomeJS linting and formatting with shared configs and monorepo patterns.

bump-deps
Batch npm/pnpm/yarn/bun dependency updates with structured planning and validation.

bump-release
Cut releases with version bumps, changelogs, commits, and tags for single packages or monorepos.

cli-gh
GitHub CLI automation for repository reads, workflows, search, codespaces, and releases.

cms-migration
Design Payload CMS collections interactively from your source CMS data before migration.

payload
TypeScript-first Next.js CMS with admin panel, REST/GraphQL APIs, and extensible hooks for content management.