OpenParable
Skip to content
← Back to skills

Check Push

Testing & Quality
check-push

Check Push is an Agent Skill for testing & quality published in the pockethost/pockethost repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

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.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/pockethost/pockethost/blob/HEAD/.cursor/skills/check-push/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/check-push, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

check:push

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

Run

pnpm check:push

Equivalent to:

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)

pnpm lint:fix

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

Types — pockethost

pnpm --filter pockethost check:types

Types — phio

pnpm --filter phio check:types

Types — dashboard

pnpm --filter @pockethost/dashboard check:types

Mothership hooks stale

pnpm --filter pockethost-mothership-app build

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

Tests

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
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).