PluginBench
Skill
Review
Audit score 70

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
Prerequisites
  • 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)
Claude Code
Cursor
Windsurf
Cline

How to use yeet

  1. 1.Determine the workflow type based on user intent (create PR, update issue, comment discussion, etc.)
  2. 2.Load the appropriate reference file from the skill's references/ directory
  3. 3.Use yeet-context.sh helper to fetch repository, template, or thread context as needed
  4. 4.For YAML forms, use issue-form.py to inspect templates and render answers
  5. 5.Verify GitHub CLI authentication with a read-only gh command
  6. 6.Execute the workflow (create, update, or post) without confirmation gates
  7. 7.Verify the contribution exists in final state and readback the GitHub URL

Use cases

Good for
  • 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
Who it's for
  • AI agents managing GitHub workflows
  • Development teams automating contribution creation
  • Repository maintainers standardizing issue and PR formats

yeet FAQ

What does 'coordination-exempt' mean?

This skill skips the ai-coord gate for its declared work, allowing it to proceed directly with GitHub operations without coordination checks.

How does idempotency work in this skill?

After a failed write, run the linked idempotency check before retrying. This prevents duplicate contributions and handles partial failures gracefully.

Can I use custom templates?

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.

What if GitHub CLI authentication fails?

Use the first required read-only gh command in each workflow as authentication validation. If it fails, resolve authentication before proceeding.

How are metadata permissions handled?

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.

WorkflowTriggerReference
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.