How do I install the Gp skill?

Run npx skillmds@latest add yokeloop/gp in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Gp skill do?

Git push with checks and report. Used when the user writes "push", "gp", "git push". It is listed under Docs & Writing on SkillMD.

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Gp?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

yokeloop (@yokeloop) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Gp by yokeloop — Agent Skill

Name: Gp
Author: yokeloop

File contents

Git push with checks and report

Push orchestrator: collect state, push, report. Runs autonomously — no confirmation prompts.

Input

$ARGUMENTS — optional flags (--force-with-lease).

Step 1 — Pre-check

One call:

bash ${CLAUDE_PLUGIN_ROOT}/lib/gp-precheck.sh

Parse the structured block. Single-value fields are KEY: value; list fields (UNCOMMITTED_LIST) span from the line after KEY: to the next top-level KEY:.

Step 2 — Decide

Blocking (report and stop):

ERRORS contains detached HEAD → "Checkout a branch before push".
ERRORS contains no remote → "Add a remote: git remote add origin <url>".
UNPUSHED_COMMITS = 0 and HAS_UPSTREAM = true → "Nothing to push" (if UNCOMMITTED_FILES > 0, add: commit first with /yoke:gca).

Non-blocking:

GH_AUTH != ok → push still proceeds; only PR/URL info is skipped in the report.
UNCOMMITTED_FILES > 0 → never blocks. git push sends only commits; note them in the report.

PUSH_MODE:

HAS_UPSTREAM = false → set-upstream
$ARGUMENTS contains --force-with-lease → force-with-lease
otherwise → normal

Step 3 — Push

One call:

bash ${CLAUDE_PLUGIN_ROOT}/lib/gp-push.sh "<BRANCH>" "<PUSH_MODE>"

If PUSH_STATUS = FAILED → show PUSH_ERROR. If it contains "non-fast-forward" → suggest git pull --rebase or /yoke:gp --force-with-lease. Stop.

Step 4 — Report

Fill from the gp-push.sh block; Commits: ← PUSHED_LIST:

Pushed to origin/<BRANCH>: +<PUSHED_COMMITS> commits

Commits:
  <PUSHED_LIST>

Stats: <DIFF_STAT>
Link: <BRANCH_URL>

Omit the Link: line when BRANCH_URL = empty.
PR_EXISTS = true → add PR: <PR_TITLE> (<PR_URL>) and suggest /yoke:pr to update it.
PR_EXISTS = false → suggest /yoke:pr to create one.
UNCOMMITTED_FILES (carried from Step 1) > 0 → add Uncommitted (not pushed): <N> files.

Print the report and the suggestion — do not ask a follow-up question.

Rules

Runs autonomously: no confirmation prompts.
Remote: origin. When multiple remotes exist — push to origin.
gh is optional; its absence only removes PR/URL info, never blocks the push.
The only mutation is git push (inside lib/gp-push.sh).
Output limit: max 20 commits.

---name: gpdescription: Git push with checks and report. Used when the user writes "push", "gp", "git push".---# Git push with checks and reportPush orchestrator: collect state, push, report. Runs autonomously — no confirmation prompts.## Input`$ARGUMENTS` — optional flags (`--force-with-lease`).---## Step 1 — Pre-checkOne call:```bashbash ${CLAUDE_PLUGIN_ROOT}/lib/gp-precheck.sh```Parse the structured block. Single-value fields are `KEY: value`; list fields (`UNCOMMITTED_LIST`) span from the line after `KEY:` to the next top-level `KEY:`.---## Step 2 — DecideBlocking (report and stop):- `ERRORS` contains `detached HEAD` → "Checkout a branch before push".- `ERRORS` contains `no remote` → "Add a remote: `git remote add origin <url>`".- `UNPUSHED_COMMITS = 0` and `HAS_UPSTREAM = true` → "Nothing to push" (if `UNCOMMITTED_FILES > 0`, add: commit first with `/yoke:gca`).Non-blocking:- `GH_AUTH != ok` → push still proceeds; only PR/URL info is skipped in the report.- `UNCOMMITTED_FILES > 0` → never blocks. `git push` sends only commits; note them in the report.PUSH_MODE:- `HAS_UPSTREAM = false` → `set-upstream`- `$ARGUMENTS` contains `--force-with-lease` → `force-with-lease`- otherwise → `normal`---## Step 3 — PushOne call:```bashbash ${CLAUDE_PLUGIN_ROOT}/lib/gp-push.sh "<BRANCH>" "<PUSH_MODE>"```If `PUSH_STATUS = FAILED` → show `PUSH_ERROR`. If it contains "non-fast-forward" → suggest `git pull --rebase` or `/yoke:gp --force-with-lease`. Stop.---## Step 4 — ReportFill from the `gp-push.sh` block; `Commits:` ← `PUSHED_LIST`:```Pushed to origin/<BRANCH>: +<PUSHED_COMMITS> commitsCommits: <PUSHED_LIST>Stats: <DIFF_STAT>Link: <BRANCH_URL>```- Omit the `Link:` line when `BRANCH_URL = empty`.- `PR_EXISTS = true` → add `PR: <PR_TITLE> (<PR_URL>)` and suggest `/yoke:pr` to update it.- `PR_EXISTS = false` → suggest `/yoke:pr` to create one.- `UNCOMMITTED_FILES` (carried from Step 1) `> 0` → add `Uncommitted (not pushed): <N> files`.Print the report and the suggestion — do not ask a follow-up question.---## Rules- Runs autonomously: no confirmation prompts.- Remote: `origin`. When multiple remotes exist — push to origin.- `gh` is optional; its absence only removes PR/URL info, never blocks the push.- The only mutation is `git push` (inside `lib/gp-push.sh`).- Output limit: max 20 commits.

Frequently asked questions

Gp