Index of every page on this site: llms.txt
All skills
openai avatar

/yeet

@49f948f official
by openaiopenai/skills29k stars
2,023
Run it yourself

Use only when the user explicitly asks to stage, commit, push, and open a GitHub pull request in one flow using the GitHub CLI (`gh`).

Use this Skill: https://skilld.dev/gh/openai/skills/yeet

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

SKILL.md

≈35 tokens for metadata: the name and description. ≈1.7k when used: this file. ≈69 more on demand in 1 file.

Description uses 1.8% of example budget

Before choosing a Skill, your Agent reads its name and description. All available Skills share that space.

  • A shorter description leaves more room for other Skills. This entry exceeds our 1% size suggestion.

In our Claude Code example, all Skill names and descriptions share 8,000 characters. This Skill uses ≈141 characters, or 1.8%.

The 1% threshold is a size suggestion. Longer descriptions can still fit.

Your model, settings, and other Skills decide how much text your Agent can read.

Example settings and source

The example uses a 200k-token context and default Claude Code settings. The count includes the name, description, separators, and when_to_use when present. Codex also counts local file paths.

Skit's source and limits: Codex 0.160.1, Claude Code 2.1.292.

Prerequisites

  • Require GitHub CLI gh. Check gh --version. If missing, ask the user to install gh and stop.
  • Require authenticated gh session. Run gh auth status. If not authenticated, ask the user to run gh auth login (and re-run gh auth status) before continuing.

Naming conventions

  • Branch: {description} when starting from main/master/default.
  • Commit: {description} (terse).
  • PR title: {description} summarizing the full diff.

PR template discovery

Before creating the PR, resolve the repository root and look for the active GitHub PR template from there:

repo_root="$(git rev-parse --show-toplevel)"

Template candidates, in order:

  • .github/pull_request_template.md
  • .github/PULL_REQUEST_TEMPLATE.md
  • One *.md file under .github/pull_request_template/
  • One *.md file under .github/PULL_REQUEST_TEMPLATE/

Use paths as emitted from the repository root, such as .github/pull_request_template.md, not ./.github/pull_request_template.md.

If exactly one template is found, read it before composing the final PR body and pass it to gh pr create with --template "$template".

If multiple template files are found, stop before PR creation and ask which template to use. If no template exists, use the fallback body shape in this skill.

Workflow

  • If on main/master/default, create a branch: git checkout -b "{description}"
  • Otherwise stay on the current branch.
  • Confirm status, then stage everything: git status -sb then git add -A.
  • Commit tersely with the description: git commit -m "{description}"
  • Run checks if not already. If checks fail due to missing deps/tools, install dependencies and rerun once.
  • Push with tracking: git push -u origin $(git branch --show-current)
  • If git push fails due to workflow auth errors, pull from master and retry the push.
  • Discover and read the repository PR template, if any.
  • Check whether the current branch already has a PR: gh pr view "$(git branch --show-current)" --json number,isDraft,url
  • If a PR already exists, update that PR in place. Do not create another PR, and do not change whether the existing PR is draft or ready for review.
  • If no PR exists, open a new draft PR:
    • With one template: GH_PROMPT_DISABLED=1 GIT_TERMINAL_PROMPT=0 gh pr create --draft --fill --template "$template" --head "$(git branch --show-current)"
    • Without a template: GH_PROMPT_DISABLED=1 GIT_TERMINAL_PROMPT=0 gh pr create --draft --fill --head "$(git branch --show-current)"
  • Edit the PR title and body so they reflect the actual net change in the diff.
  • Write the PR description to a temp file with real newlines and pass it via --body-file or gh pr edit --body-file to avoid \n-escaped markdown.

Determining the PR

When updating a PR created earlier in the flow, infer the PR from the current branch when possible:

git branch --show-current
gh pr view "$(git branch --show-current)" --json number --jq '.number'

If this finds an existing PR, preserve its current review state. Never convert an existing ready-for-review PR back to draft as part of yeet; only new PRs created by this flow should start as draft.

PR Title

Format: <type>(<scope>): <subject>

<scope> is optional. A scope consist of a noun describing a section of the codebase (component, service or subsytem).

Example

feat: add hat wobble
^--^  ^------------^
|     |
|     +-> Summary in present tense.
|
+-------> Type: chore, docs, feat, fix, refactor, style, or test.

More Examples:

  • feat: (new feature for the user, not a new feature for build script)
  • fix: (bug fix for the user, not a fix to a build script)
  • docs: (changes to the documentation)
  • style: (formatting, missing semi colons, etc; no production code change)
  • refactor: (refactoring production code, eg. renaming a variable)
  • test: (adding missing tests, refactoring tests; no production code change)
  • chore: (updating grunt tasks etc; no production code change)

PR Body Contents

When invoked, use gh to edit the pull request body and title to reflect the contents of the specified PR. Make sure to check the existing pull request body to see if there is key information that should be preserved. For example, NEVER remove an image in the existing pull request body, as the author may have no way to recover it if you remove it.

When a repository PR template exists, adapt the final PR body to that template. Preserve meaningful headings, required checklists, and repo-specific prompts, but replace placeholder text with net-diff-specific content or N/A where the template asks for it. Do not discard template sections just because the fallback shape below is shorter.

It is critically important to explain why the change is being made. If the current conversation in which this skill is invoked has discussed the motivation, be sure to capture this in the pull request body.

The body should also explain what changed, but this should appear after the why.

Limit discussion to the net change of the commit. It is generally frowned upon to discuss changes that were attempted but later undone in the course of the development of the pull request. When rewriting the pull request body, you may need to eliminate details such as these when they are no longer appropriate / of interest to future readers.

Avoid references to absolute paths on my local disk. When talking about a path that is within the repository, simply use the repo-relative path.

Default to omitting Verification. Add it only when you have behavioral evidence worth preserving for reviewers: a reproduced bug, a before/after check, a targeted test that exercises the changed behavior, or a manual scenario with input and observed outcome. Do not use it for generic commands or automation results such as package tests, type checks, linters, formatters, pre-commit/pre-push hooks, or CI status.

If the repository template requires a validation or verification section, keep that section and avoid generic filler: include meaningful commands/results, a targeted manual scenario, or Not run with a reason.

Use professional Markdown:

  • Put code, paths, commands, flags, and identifiers in backticks.
  • Use fenced code blocks for shell transcripts or multi-line examples.
  • Use GitHub permalinks when citing existing code relevant to the change.
  • Reference relevant issues or related PRs, but do not reference the PR in its own body.

Suggested PR Body Shape

Use this as a fallback when the repository does not have a PR template:

## Why

Describe the user-facing or maintainer-facing problem, including cause and effect where useful.

## What Changed

Describe the net implementation change in concise prose.

Source: SKILL.md on GitHub

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

1 warning2mo5 checks · Risk SAFE
  • Gen Agent Trust Hub2mo

    This skill includes some security considerations such as running local CLI commands and processing repository files that could contain untrusted input. While these warrant review, they are standard for the skill's intended development workflow functionality.

  • Socket2mo

    No alerts

  • Snyk2mo

    Risk: LOW · No issues

  • Runlayer9mo

    3/3 files flagged

  • ZeroLeaks7mo

    Score: 93/100 · 2 sections analyzed

Signed by skilld at 49f948f. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub last month.

Activeupdated 6 months ago
  • Git/VCS
  • github
  • github-cli
  • pull-requests
  • workflow
  • automation

README badge

README badge for openai/skills/yeet

Stages all changes, commits with a description, runs checks, pushes to a tracking branch, and opens a GitHub pull request using the GitHub CLI (`gh`). Use this skill when you need to execute the full git-to-PR workflow in one command without manual steps in between.

Generated from the current SKILL.md.

Does this skill work without GitHub CLI installed?
No. The skill requires GitHub CLI (`gh`) to be installed and authenticated. It will check `gh --version` and `gh auth status` before proceeding and ask you to install or authenticate if either is missing.
Can I use this skill on a branch other than main?
Yes. If you are already on a non-default branch, the skill will stay on that branch. It only creates a new branch if you are on main/master/default.
What happens if the git push fails?
If the push fails due to workflow auth errors, the skill will pull from master and retry the push once.
Does this skill run tests or checks automatically?
Yes. The skill runs checks if they have not already been run, and if they fail due to missing dependencies or tools, it will install them and rerun the checks once.

Generated from the current SKILL.md. These answers refresh after source changes.