Use for GitHub PR/issue/discussion workflows: create/update PRs or issues, post comments, start discussions; triggers include yeet.
...Expand allAbout yeet
yeet facilitates GitHub-based open source contribution workflows, covering the creation and updating of pull requests and issues, posting comments, and starting discussions. Its guiding principle is semantic analysis over mechanical operation: it aims to understand the intent and context of a change before generating a title, description, or selecting a template, and it keeps all generated content conversational and informal.
The skill covers a set of distinct workflows, each documented in its own reference file that is loaded based on user intent. These include creating and updating PRs, creating and updating issues (with dedicated references for filing bugs against Claude Code, Codex CLI, and Sablier), commenting on issues, and creating discussions. Shared patterns such as authentication validation, admonitions, HEREDOC syntax, semantic analysis, tone, platform normalization, error handling, and file links live in a common reference file.
Before acting, it validates prerequisites. The first required read-only gh command in each workflow doubles as authentication validation, and it prefers a bundled scripts/yeet-context.sh helper to gather repository, template, discussion, label, or issue/PR thread context. Pull request workflows carry extra preconditions: the working tree must be clean or changes committed, the current branch must have commits ahead of the base branch, and remote tracking must be configured.
Use it when contributing to GitHub repositories and you want well-written, context-aware PRs, issues, comments, or discussions rather than boilerplate. It is triggered by phrases like create PR, open PR, yeet a PR, file issue, comment on issue, or start discussion. For detailed GitHub CLI command syntax, flags, and patterns, it defers to a related cli-gh skill, keeping its own focus on workflow orchestration and semantic content generation.
FAQ
What GitHub workflows does yeet support?
Creating and updating pull requests and issues, commenting on issues, and creating discussions, plus dedicated issue-filing references for Claude Code, Codex CLI, and Sablier.
What does it check before opening a pull request?
That the working tree is clean or changes are committed, the current branch has commits ahead of the base branch, and remote tracking is configured.
How does it authenticate with GitHub?
It uses the first required read-only gh command in each workflow as authentication validation, rather than a separate login step.
What makes yeet's generated content distinctive?
It emphasizes semantic analysis, understanding a change's intent and context before writing titles and descriptions, and keeps all output conversational and informal.
Does it handle detailed gh CLI syntax itself?
No. For detailed GitHub CLI command syntax, flags, and patterns it defers to the related cli-gh skill.
All Files
24 filesreferences/create-issue.md7.5 KBViewreferences/create-discussion.md4.1 KBViewreferences/commons.md14.3 KBViewreferences/issue-codex-cli.md7.1 KBViewagents/openai.yaml0.0 KBViewreferences/create-pr.md2.8 KBViewreferences/templates/claude-code/documentation.md1.1 KBViewreferences/templates/codex/3-cli.md1.0 KBViewreferences/update-pr.md1.8 KBViewreferences/comment-issue.md5.7 KBViewreferences/issue-claude-code.md6.9 KBViewreferences/templates/claude-code/feature-request.md1.2 KBViewreferences/templates/codex/4-bug-report.md0.3 KBViewscripts/get-macos-version.sh0.6 KBViewreferences/issue-sablier.md2.0 KBViewreferences/templates/codex/1-codex-app.md0.7 KBViewreferences/templates/codex/6-docs-issue.md0.5 KBViewSKILL.md2.7 KBViewreferences/templates/claude-code/bug-report.md1.6 KBViewreferences/templates/codex/2-extension.md0.6 KBViewreferences/update-issue.md5.7 KBViewreferences/templates/claude-code/model-behavior.md2.1 KBViewreferences/templates/codex/5-feature-request.md0.4 KBViewscripts/yeet-context.sh6.2 KBViewThis 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.
All Files
0 filesInstall yeet
Download and extract the skill files to your .claude/skills/ directory.
Download ZIPClone the repository and copy the skill files to your project.
git clone https://github.com/PaulRBerg/agent-skills/blob/main/skills/yeet/SKILL.md # Copy SKILL.md to your .claude/skills/ directory
Copy





Home
