Agent skill

Check Push

by pockethost in pockethost/pockethost

Run pnpm check:push (lint, types, tests) before git push or PR-ready work.

MITAuto-check passedDevelopment

Install Check Push

skills CLI
$ npx skills add pockethost/pockethost --skill check-push -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install pockethost/pockethost check-push --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/pockethost/pockethost.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.cursor/skills/check-push .claude/skills/check-push && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
check-push
GitHub stars
1.4k
Token cost
~665 tokens
SKILL.md length
241 words
Files
1
Skills in repo
11
Repo updated
First seen
Licence
MIT

At a glance

Run pnpm check:push (lint, types, tests) before git push or PR-ready work.

  • Works in 4 steps: Run pnpm check:push from repo root. → On failure, fix only what the output… → Repeat until exit code 0. → …
  • The user asks to push
  • SKILL.md covers Run, Procedure, Failure triage and Dashboard build (CI only), plus 2 more sections
  • Calls pnpm and git

What it does

Check Push is an agent skill from pockethost/pockethost. Run pnpm check:push (lint, types, tests) before git push or PR-ready work. Use when the user asks to push, open a PR, reports a failed pre-push hook, or when substantive code changes are finished and push is next.

Its SKILL.md is about 670 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development, covering Linting and formatting and Pull requests. It works with pnpm and Git. The repository describes itself as: Open source multitenant PocketBase server. The licence is MIT.

When your agent uses it

  • The user asks to push
  • Reports a failed pre-push hook
  • Substantive code changes are finished and push is next

Example prompts

  • “/check-push”

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Run pnpm check:push from repo root.
  2. On failure, fix only what the output names. Re-run the failing step (or full check:push before push).
  3. Repeat until exit code 0.
  4. Only then suggest git push or create the PR.

What it can do on your machine

Read from SKILL.md and the folder at commit 82c9ba3. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • pnpm
    • git

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use pnpm and git, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Check Push loads about 665 tokens when it runs. Until then it costs about 56 tokens; SKILL.md has 241 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~56
When it runs · the whole SKILL.md, loaded when a task matches
~665

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from pockethost/pockethost at commit 82c9ba3, republished under its MIT licence (© pockethost). 241 words, ~665 tokens.

Download SKILL.mdSave it as .claude/skills/check-push/SKILL.md (or your agent's skills folder).
name
check-push
description
Run pnpm check:push (lint, types, tests) before git push or PR-ready work. Use when the user asks to push, open a PR, reports a failed pre-push hook, or when substantive code changes are finished and push is next.

check:push

Prevents .husky/pre-push failures. Command mirrors CI quality + mothership hook freshness (no dashboard build).

Run

bash
pnpm check:push

Equivalent to:

bash
pnpm lint && \
  pnpm --filter pockethost check:types && \
  pnpm --filter phio check:types && \
  pnpm --filter @pockethost/dashboard check:types && \
  pnpm check:mothership-hooks && \
  pnpm test

Procedure

  1. Run pnpm check:push from repo root.
  2. On failure, fix only what the output names. Re-run the failing step (or full check:push before push).
  3. Repeat until exit code 0.
  4. Only then suggest git push or create the PR.

Do not use --no-verify unless the user explicitly asked to skip hooks.

Failure triage

Prettier (pnpm lint)
bash
pnpm lint:fix

Or format touched files only. Re-run pnpm lint.

Types — pockethost
bash
pnpm --filter pockethost check:types
Types — phio
bash
pnpm --filter phio check:types
Types — dashboard
bash
pnpm --filter @pockethost/dashboard check:types
Mothership hooks stale
bash
pnpm --filter pockethost-mothership-app build

Commit regenerated pb_hooks/, then re-run pnpm check:mothership-hooks.

Tests
bash
pnpm test

For a single file: pnpm vitest run path/to/file.test.ts

Dashboard build (CI only)

Pre-push does not run dashboard build. svelte-check will not catch prerender failures.

Run pnpm check:ci (adds dashboard build) before push or merge when you changed any of:

  • Files under packages/dashboard/src/routes/(static)/
  • $page.url, page.url.searchParams, query-string banners, or URL-driven UI
  • +layout.ts / +page.ts with prerender, ssr, or csr
  • svelte.config, Vite config, or static adapter settings
bash
pnpm check:ci
Prerender build failure

Symptom: Cannot access url.searchParams on a page with prerendering enabled or Error: 500 /some-route during vite build.

Fix: see Prerender (static routes) in .cursor/rules/dashboard-ux.mdc. Usually guard with browser or move the read to onMount. Re-run pnpm check:ci.

Pair with commit

After /commit or when commits are done and push is next, run check:push before git push.

Report

State pass/fail, what you fixed, and that the branch is safe to push (or what still blocks).

© pockethost, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .cursor/skills/check-push of pockethost/pockethost.

Open the folder on GitHubat commit 82c9ba3

Compare with similar skills

Check Push next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Check Push compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Check Push this skillpockethost/pockethost1.4k—~665Automated safety check: PassMIT
Verdaccio Pull Request Workflowverdaccio/verdaccio18k—~1.9kAutomated safety check: PassMIT
Lint Commit PRTresjs/tres3.8k—~1.1kAutomated safety check: PassMIT
PR Pushicebear0828/codex-proxy1.8k—~2.2kAutomated safety check: NotesCustom licence
Contributingkortix-ai/suna20k—~3kAutomated safety check: WarnCustom licence
PR Pushicebear0828/codex-proxy1.8k—~2.3kAutomated safety check: NotesCustom licence

Similar skills

  • Takes a change through a verdaccio pull request: branch, local checks, changeset, title and body, labels, CI and review rounds, and ports to other release lines.

    18k GitHub stars~1.9k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Lint Commit PR

    Tresjs/tres

    Lint local changes, auto-fix, conventional commit, and optionally create PR

    3.8k GitHub stars~1.1k tokensUpdated today
    DevelopmentAuto-check passed
  • PR Push

    icebear0828/codex-proxy

    Package the current working changes into a standards-compliant codex-proxy pull request: branch hygiene, commit message linting, CHANGELOG prompt, conventional commit, push, and gh pr create against…

    1.8k GitHub stars~2.2k tokensUpdated yesterday
    DevelopmentAuto-check: notes
  • Contributing

    kortix-ai/suna

    The pull request loop for this repo: branch → commit → verify in your own box (local tests + local stack) → PR into main → demo video recorded with agent-browser on the local stack → gh --attach →…

    20k GitHub stars~3k tokensUpdated today
    DevelopmentAuto-check: warnings
  • PR Push

    icebear0828/codex-proxy

    Package the current working changes into a standards-compliant codex-proxy pull request: branch hygiene, commit message linting, CHANGELOG prompt, conventional commit, push, and gh pr create against…

    1.8k GitHub stars~2.3k tokensUpdated yesterday
    DevelopmentAuto-check: notes
  • Adk Setup

    google/adk-python

    Official

    Sets up a local ADK Python development environment in a git clone of the open-source adk-python repository: a uv virtual environment, all dependency extras, pre-commit hooks, and a first unit-test…

    22k GitHub stars~993 tokensUpdated today
    DevelopmentAuto-check: notes

More from pockethost/pockethost

All 11 skills in this repo
  • Blog Voice

    pockethost/pockethost

    Write PocketHost blog posts in Ben Allfree's voice (@cap'n).

    1.4k GitHub stars~977 tokensUpdated 10 days ago
    Auto-check passed
  • Commit

    pockethost/pockethost

    Create scoped git commits from the current conversation (e.g.

    1.4k GitHub stars~1.3k tokensUpdated 10 days ago
    Auto-check: notes
  • Feature Blog

    pockethost/pockethost

    Ship user-facing PocketHost features with a blog post instead of semver release notes.

    1.4k GitHub stars~818 tokensUpdated 10 days ago
    Auto-check passed
  • Lemon Squeezy Integration

    pockethost/pockethost

    Full Lemon Squeezy integration — REST API, @lemonsqueezy/lemonsqueezy.js server SDK, Lemon.js checkout overlays, webhooks, customdata, and subscriptions.

    1.4k GitHub stars~1.1k tokensUpdated 10 days ago
    Auto-check passed
  • Pocketbase

    pockethost/pockethost

    Models PocketBase backends: collections, relations, auth, API rules, migrations, and architecture.

    1.4k GitHub stars~1k tokensUpdated 10 days ago
    Auto-check passed
  • Pocketbase Admin Plugins

    pockethost/pockethost

    Builds PocketBase superuser admin UI extensions (admin plugins) on PB ≥0.37: ServeEvent.uiExtensions, client main.js, window.app SPA hooks, Shablon UI, reactive stores, CSP, SSE/realtime topics.

    1.4k GitHub stars~1.8k tokensUpdated 10 days ago
    Auto-check passed

Works with

Categories

Questions about Check Push

What does Check Push do?

Run pnpm check:push (lint, types, tests) before git push or PR-ready work. Check Push is an agent skill from pockethost/pockethost. Run pnpm check:push (lint, types, tests) before git push or PR-ready work.

When should I use Check Push?

Check Push fits situations like: the user asks to push; reports a failed pre-push hook; substantive code changes are finished and push is next.

How do I install Check Push in Claude Code?

Run `npx skills add pockethost/pockethost --skill check-push -a claude-code`. Or copy the skill folder (.cursor/skills/check-push in pockethost/pockethost) into .claude/skills/check-push in your project. Claude Code loads it when a task matches its description.

How do I install Check Push in Codex?

Run `npx skills add pockethost/pockethost --skill check-push -a codex`. Or copy the skill folder (.cursor/skills/check-push in pockethost/pockethost) into .agents/skills/check-push in your project. Codex loads it when a task matches its description.

Can I use Check Push in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add pockethost/pockethost --skill check-push -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/check-push, .gemini/skills/check-push, .github/skills/check-push and .opencode/skills/check-push in your project.

What does Check Push need to run?

Going by SKILL.md and its folder, Check Push needs the command-line tools its instructions call (pnpm and git).

Does Check Push access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Check Push safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Check Push use?

Check Push is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Check Push use?

About 665 tokens (SKILL.md is roughly 2.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Check Push?

Skills that share tags, products or a category with Check Push: Verdaccio Pull Request Workflow (verdaccio/verdaccio, 18k stars), Lint Commit PR (Tresjs/tres, 3.8k stars), PR Push (icebear0828/codex-proxy, 1.8k stars) and Contributing (kortix-ai/suna, 20k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Check Push?

pockethost (a GitHub organization) maintains it in pockethost/pockethost, which has 1,444 GitHub stars. The repository holds 11 skills in this directory. The repository was last updated on September 28, 2026.

Source: pockethost/pockethost on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.