GitHub `yeet` skill incorrectly requires `gh` despite connector-first workflow
Nobody has claimed this yet.
- Dominant language
- Rust
- Stars
- 125k
- Forks
- 19.5k
- PR merge metrics
- PR metrics pending
Description
What issue are you seeing?
The GitHub plugin's yeet skill describes a connector-first workflow, but its prerequisites unconditionally require GitHub CLI (gh) and stop if it is unavailable.
Source:
https://github.com/openai/plugins/blob/main/plugins/github/skills/yeet/SKILL.md
The skill says:
- Prefer the GitHub app for pull request creation.
- Use
ghonly as a fallback when connector coverage is insufficient.
But the Prerequisites section then says:
- Require
ghand rungh --version. - Stop and ask the user to install it if it is missing.
- Require an authenticated
ghsession before continuing.
These instructions contradict each other. In a ChatGPT-login Codex session where the GitHub connector is available and exposes pull-request creation, the skill still stops immediately when gh is not installed. The connector path is never attempted.
What steps can reproduce the bug?
- Use a Codex environment with the GitHub plugin and an authenticated GitHub connector.
- Ensure the connector can create pull requests.
- Use a local Git repository where ordinary
gitis available, but GitHub CLIghis not installed. - Ask Codex to commit, push, and open a draft pull request.
- The
yeetskill runsgh --version, receivescommand not found, asks the user to installgh, and stops.
What is the expected behavior?
The skill should:
- Use local
gitfor branch creation, staging, commit, and push. - Use the GitHub connector by default to create the pull request.
- Check for
ghonly if connector coverage is actually insufficient. - Treat missing or unauthenticated
ghas a blocker only for that fallback path.
Suggested change
Replace the unconditional CLI prerequisites with connector-first prerequisites, for example:
## Prerequisites
- Require a local Git repository and a clear understanding of which changes belong in the pull request.
- Use the GitHub connector by default for pull request creation.
- Do not require or check GitHub CLI (`gh`) when the connector can inspect the repository and create the pull request.
- Check `gh --version` and `gh auth status` only when connector coverage is insufficient and the CLI fallback is required.
- Missing or unauthenticated `gh` blocks only the fallback path.
This would make the prerequisites consistent with the skill description and the connector-first workflow already documented in the same file.
Additional information
Observed with the curated GitHub plugin skill cached as version 0.1.8-2841cf9749ae. The same contradictory prerequisites are present in the current public main version of the source file.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Open plugins/github/skills/yeet/SKILL.md and read the Prerequisites section alongside the connector-first workflow described in the skill. Align the prerequisites so GitHub connector availability is checked first and gh is only required for the fallback path. Done means the documented workflow no longer stops when gh is absent but the connector can create pull requests.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- github, markdown
- Domain
- documentation
- Issue type
- Documentation
- Difficulty
- 1/5
- Estimated time
- Under an hour
- Activity status
- Quiet
- Clarity
- Clearly specified
- Newbie friendliness
- 90/100