head-over-heels-online

Take a set of local feature branches/worktrees all the way to merged PRs — discover unmerged work, fix commit-time hygiene, push, raise PRs, watch CI, auto-fix mechanical failures, merge on green, and cascade-rebase the rest. Use when the user says "shepherd PRs" or wants several branches driven to merge autonomously.

Read BEFORE invoking `playwright test` in any form, for any reason — running e2e, visual regression, room snapshots, or verifying a change 'via e2e'. Covers required project scoping (chromium-desktop, matching CI), the sandbox browser-build bridge, and the pnpm webServer failure. Also load on these failure signatures: every test failing at browserType.launch, 'Executable doesn't exist at /opt/pw-browsers/...', or 'Process from config.webServer was not able to start'.

Run the true-site-size GitHub Action locally via `act` inside the Claude Code web sandbox, to measure the game/editor cold-load journey byte cost without a CI round-trip. Use when asked to measure or verify build/wire size, or to check a byte-saving change, in the sandbox.

Fetch a campaign from the Supabase DB and save as local JSON. Use when the user asks to load, download, or fetch a campaign from the database.

Drive the Head over Heels remake's UI via the chrome-devtools MCP. Use this skill when the user asks for browser automation, capturing localStorage, dispatching game actions, or anything that involves driving the running game on localhost.

Run Docker — and tools that need it, like `act` (local GitHub Actions) — inside the Claude Code web sandbox, where image pulls and in-container networking collide with the egress proxy. Use when `docker pull` returns 403 on image layers, when a container can't reach the network, or when running `act`/CI-in-docker locally (e.g. the `act-true-site-size.sh` script).

Edit the BlockStack spritesheet — its IFF source of truth, image layout and cell grid, palette and two-tone colour rules, the iff→webp conversion pipeline, and how to hand-edit in DPaint/pyDPainter or bake webp-only art back into the IFF. Use when adding or changing sprites, fixing sprite art, or reconciling the IFF and webp.

Game engine internals reference — vector in-place mutation safety policy, available vector utilities, item times/multiplied items, and moved-items tracking. Use when working on physics, item positioning, vector maths, or the main loop.

QA the level editor via the chrome-devtools MCP — start the dev server, open it in a browser, dispatch actions, and verify Redux state. Use when testing editor features interactively.

Find and remove git worktrees whose PRs have been merged to main. Use when the user says "clean worktrees", "prune worktrees", or wants to tidy up stale worktree branches.

Update the Toppy spritesheet from a downloaded PNG. Use when the user has downloaded a new spritesToppy.png to ~/Downloads and wants to integrate it into the codebase.

Pre-flight checks, commit hygiene, PR creation, and CI monitoring for shipping a branch. Use when the user says "ship", "ship it", "merge this", "raise a PR", or wants to go through the commit-and-PR workflow.

Procedure for moving files from src/ into monorepo packages. Use when moving, extracting, or migrating files into @blockstacking/* packages.

Redux store architecture reference — slice layout, intra-slice composition patterns (extraReducers, listeners, cross-slice actions), intent-revealing reducers, persistence, listener API conventions, and the app-typed vs slice-typed hook hierarchy. Use when working on state management, slices, listeners, or redux hooks.

Spritesheet variant architecture reference — the six parallel spritesheets, initialisation flow, colourised vs uncolourised split, and how renderers pick a variant. Use when working on sprite rendering, palette swaps, or debugging "swopped spritesheet undefined" errors.

Convert a markdown file to a JSON array of strings for embedding inline in room JSON scroll configs

Write markdown content for in-game scrolls in the Head over Heels remake, matching the tone and conventions of the existing manual files

Add an e2e migration test by capturing localStorage from the live site and writing a Playwright test that seeds it before page load. Use when: the user says 'add a migration test', 'capture a fixture from prod', or similar.