push

A workflow for staging, committing, checking, and pushing changes on the current Git branch. Git is a system for tracking changes to source code and coordinating work across branches.

In plain words
What is it for?
Use it when you are ready to prepare a change for sharing: stage the intended files, create a convention-compliant commit, type-check or verify the work, and push it.
Why use it?
It gives the delivery process a defined way to select files, follow commit conventions, run checks, and publish the branch.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/devstride/claude-plugin/push
Any agent
npx skills add devstride/claude-plugin --skill push
Clone the repo
git clone --depth 1 https://github.com/devstride/claude-plugin

Made for: Claude Code, Codex.

Per session 18 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 892 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00018 $0.00892
Opus 5 $0.00009 $0.00446
Sonnet 5 $0.00004 $0.00178
Haiku 4.5 $0.00002 $0.00089

Measured yesterday against content hash 707f121924e1, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

push scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/push/SKILL.md · 58 lines

What it actually says

Human output. Read ${CLAUDE_PLUGIN_ROOT}/skills/build-item/references/plain-language-output.md once per top-level run; composed skills reuse it. Apply it to every message.

Load .claude/ds-config.json first. Its verify, generated, protectedBranches and commitConventions values are authoritative; absent → use stated fallbacks and say so.

Execute the following git workflow:

  1. Run git add -u to stage changes to already-tracked files only (do NOT sweep in untracked files with git add .)
  2. Run git status to see what's being committed — and stage any NEW file the change requires, BY NAME (git add path/to/new-file.ts). git add -u misses new files. Never use git add .; leave unrelated untracked files alone
  3. Run git diff --cached --stat to show a summary of staged changes
  4. Create a commit with a meaningful message per commitConventions (fallback: Conventional Commits with the item tag, shaped per itemTagFormat — e.g. [I#####], [PROJ-123] — so a repo whose tracker does not use DevStride-style numbers can still express its own). The item tag applies only when the work HAS an associated item — an itemless commit (a merge, a repo chore) keeps a meaningful conventional message with no tag; never compose an item number to satisfy the format
    • AI attribution trailers are optional. If the active session exposes valid current-session attribution metadata, append Co-Authored-By: plus the matching provider-specific session trailer (Claude-Session: or Codex-Session:). If that metadata is unavailable or incomplete, omit the AI trailers and continue without stopping to ask. Never invent values or reuse stale/example metadata.
    • The "no AI attribution" rule still applies to PR BODIES. Optional attribution belongs only on commits.
  5. Resolve the exact type-check command list (verify.typecheck array, in order; use verify.typecheckCombined only when the array is absent). A caller may pass a verification receipt. Reuse it only when every validity rule in ${CLAUDE_PLUGIN_ROOT}/skills/build-item/references/verification-receipts.md holds for the current tree and this exact list. Step 4 normally created a new commit and invalidated an older receipt, so run every command unless same-tree proof genuinely exists. With no command, ask rather than guessing. After a pass, write/refresh the receipt for downstream callers
  6. If the type-check passes, OR the only failures are generated-file errors tolerated by generated.toleratedTypeErrors in files matched by generated.paths:
    • Push to remote with git push
    • If push is rejected (non-fast-forward), use git push --force-with-lease to force push safely
    • On success, recap the commit, branch, push result and checks that passed or did not run.
  7. If TypeScript check fails with non-SDK errors:
    • Do NOT push
    • Report the errors and ask what to do

Do NOT create a pull request. This command stages, commits, and pushes only — PRs are opened separately when you're ready, not on every push.

Tolerated generated-file errors are defined by config: an error is tolerated only when its file matches generated.paths AND its text matches a pattern in generated.toleratedTypeErrors. With neither key configured, nothing is tolerated — any type error stops the push, which is the right default: a repo that has not declared generated files has none to forgive. Where they are configured, fix such an error by re-running generated.regenCommand, never by hand-editing the generated file.

IMPORTANT:

  • Always use force-with-lease instead of force for safety
  • Only force push if the rejection is due to rewriting history on the current branch
  • Never force push to main/master branches
Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. yesterday First seen · 58 lines · 18 tokens per session scan A 707f121924e1

Subscribe to this mod's changes

push is a skill published in the GitHub repository devstride/claude-plugin (2 stars, last pushed 3d ago), licensed MIT. It adds 18 tokens to every session and 892 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

systematic-debugging

Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes.

obra/superpowers · 21 tokens

next-cache-components-adoption

Turn on Cache Components in a Next.js app and resolve the blocking routes it surfaces. Use when the user wants to enable, adopt, or migrate to Cache Components, flip the cacheComponents flag, work through a flood of blocking-prerender / instant validation errors, run the cache-components-instant-false codemod, or…

vercel/next.js · 95 tokens

babysit-pr

Babysit a GitHub pull request after creation by continuously polling review comments, CI checks/workflow runs, and mergeability state until the PR is merged/closed or user help is required. Diagnose failures, retry likely flaky failures up to 3 times, auto-fix/push branch-related issues when appropriate, and keep…

openai/codex · 114 tokens

imagegen

Generate or edit raster images when the task benefits from AI-created bitmap visuals such as photos, illustrations, textures, sprites, mockups, or transparent-background cutouts. Use when Codex should create a brand-new image, transform an existing image, or derive visual variants from references, and the output…

openai/codex · 113 tokens

cpu-profile-analysis

Analyze V8/Chrome CPU profiles (.cpuprofile) and DevTools trace files (Trace-.json). Use when: profiling performance, investigating slow functions, comparing code paths, finding bottlenecks, analyzing timeToRequest, understanding call trees from sampling profiler data, analyzing layout/paint/rendering, investigating…

microsoft/vscode · 71 tokens

next-cache-components-optimizer

Drive a Next.js route to instant navigation by setting up an agentic loop, under Cache Components / PPR, on initial load (hard navigation) and client-side navigation (soft navigation). Encode the goal as a failing @next/playwright instant() e2e and work it to green, one verified route at a time; the shipped test then…

vercel/next.js · 170 tokens