[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M698RMCYQZM93HRHEZ2N4JP9":3,"skill-same:01M698RMCYQZM93HRHEZ2N4JP9":66},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":37,"linkOnly":38,"markdownContent":39,"markdownBody":40,"frontMatter":41,"refName":42,"commitSha":43,"skillDirectory":44,"forksCount":45,"repositoryHtmlUrl":46,"repositoryHomepageUrl":47,"ownerHtmlUrl":48,"ownerBlogUrl":49,"ownerDescription":50,"updatedAt":51,"install":52,"resources":65},"01M698RMCYQZM93HRHEZ2N4JP9","crabbox",null,"Detect and use Crabbox for repository tests and validation on remote runners. Use when crabbox.yaml or .crabbox.yaml exists, the crabbox CLI is available, or work needs remote compute, a clean or reusable environment, target-platform coverage, or auditable execution evidence.","openclaw\u002Fcrabbox","openclaw","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F252820863?v=4","01M698P3FSAZ6B4R928ZF19KPT","01M698RF0GPYHWWMQ8Y3AZVZ1R",1538,"MIT","https:\u002F\u002Fgithub.com\u002Fopenclaw\u002Fcrabbox\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fcrabbox\u002FSKILL.md",[],[5,18,19,20,21,22,23,24,25,26,27,28,29,30,31,32,33,34,35,36],"use","for","remote","detect","tests","platform","compute","clean","reusable","evidence","environment","coverage","work","execution","repository","yaml","runners","validation","cli","2026-11-10 10:12:30",false,"---\nname: crabbox\ndescription: \"Detect and use Crabbox for repository tests and validation on remote runners. Use when crabbox.yaml or .crabbox.yaml exists, the crabbox CLI is available, or work needs remote compute, a clean or reusable environment, target-platform coverage, or auditable execution evidence.\"\nlicense: MIT\n---\n\n# Crabbox\n\nUse Crabbox when a project needs remote proof, larger cloud capacity, a fresh\nPR checkout, a reusable warmed box, GitHub Actions-style setup, durable run\nlogs\u002Fresults, UI proof artifacts, or sync from a dirty local checkout.\n\n## Detect Crabbox\n\n- Treat repo-root `crabbox.yaml` or `.crabbox.yaml` as an intentional signal to\n  use this skill for validation work. `.crabbox.yml` is not a supported config\n  filename.\n- If neither config exists, `command -v crabbox` still identifies an installed\n  CLI. Run `crabbox doctor` before depending on it for remote work.\n- Inspect config before executing it. Detection does not imply permission to\n  expose secrets, bypass command approval, or start paid infrastructure.\n\n## Source Of Truth\n\n- Run Crabbox from the repository root; sync mirrors the current checkout.\n- Treat repo-local `crabbox.yaml` or `.crabbox.yaml` as executable project\n  automation. Review it before remote runs, especially `provider`, `actions`,\n  `jobs`, `profiles`, `env.allow`, artifacts, and cleanup policy.\n- Verify the installed binary before relying on examples:\n  `command -v crabbox && crabbox --version && crabbox --help | sed -n '1,120p'`.\n- Use `crabbox providers` or `crabbox providers --json` for the current\n  provider\u002Fcapability matrix; provider docs can lag the compiled binary.\n- Use `crabbox doctor` for live readiness checks and `crabbox config show` to\n  inspect merged config without printing secrets.\n- Prefer local targeted tests for tight edit loops. Move to Crabbox for broad\n  suites, package-heavy checks, Docker\u002FE2E\u002Flive-provider proof, cross-OS proof,\n  UI proof, or commands that bog down the local machine.\n\n## Auth And Config\n\nBrokered operation needs a coordinator URL and token. First login usually needs\nan explicit broker URL:\n\n```sh\ncrabbox login --url \u003Cbroker-url>\ncrabbox whoami\ncrabbox doctor\n```\n\nAfter `broker.url` is configured, `crabbox login` can reuse it. Trusted operator\nautomation can store a shared token without putting it on argv:\n\n```sh\nprintf '%s' \"$CRABBOX_COORDINATOR_TOKEN\" |\n  crabbox login --url \u003Cbroker-url> --provider aws --token-stdin\n```\n\nConfig precedence is `flags > env > repo config > user config > defaults`.\nDefault user config is `~\u002FLibrary\u002FApplication Support\u002Fcrabbox\u002Fconfig.yaml` on\nmacOS, `~\u002F.config\u002Fcrabbox\u002Fconfig.yaml` on Linux, or\n`$XDG_CONFIG_HOME\u002Fcrabbox\u002Fconfig.yaml` when set. `crabbox config path` prints\nthe active user config path.\n\nKeep provider and broker tokens out of repo config and command arguments. Use\nenvironment variables, a credential store, coordinator-managed secrets, or a\nshort-lived token command.\n\n## Choose The Remote Surface\n\n- `crabbox run -- \u003Ccommand>`: one command on a fresh or reused box.\n- `crabbox warmup`: create a reusable lease and run commands later with `--id`.\n- `crabbox prewarm`: warm a reusable lease and hydrate it from configured\n  GitHub Actions.\n- `crabbox job run \u003Cname>`: use a repo-local named flow that expands to\n  warmup, optional hydration, run, and stop.\n- `crabbox run --pool \u003Ckey>`: borrow a hydrated broker ready-pool lease, run,\n  then return\u002Fdrain\u002Frelease it according to `--pool-return`.\n- `crabbox run --fresh-pr ...`: ignore local sync and check out a GitHub PR on\n  the remote; add `--apply-local-patch` to test local uncommitted changes on\n  top of that PR.\n- `crabbox run --provider ssh`: use an existing macOS, Linux, or Windows host.\n- `crabbox warmup --desktop --browser`: provision a visible desktop\u002Fbrowser for\n  UI testing, WebVNC, screenshots, and artifacts.\n\nIf remote proof is blocked, name the missing capability precisely: auth,\ncoordinator, capacity, provider support, target OS, hydration, secret access,\nartifact storage, desktop support, or a delegated-provider limitation.\n\n## Common Remote Proof\n\nOne-shot command:\n\n```sh\ncrabbox run --preflight --timing-json -- pnpm test\n```\n\nWarm and reuse a lease:\n\n```sh\ncrabbox warmup --class beast --idle-timeout 90m\ncrabbox status --id \u003Ccbx_id-or-slug> --wait\ncrabbox run --id \u003Ccbx_id-or-slug> -- pnpm test:changed\ncrabbox run --id \u003Ccbx_id-or-slug> --full-resync -- pnpm test:changed\ncrabbox stop \u003Ccbx_id-or-slug>\n```\n\nUse a repo-local job when configured:\n\n```sh\ncrabbox job list\ncrabbox job run --dry-run \u003Cjob-name>\ncrabbox job run \u003Cjob-name>\ncrabbox job run --id \u003Ccbx_id-or-slug> \u003Cjob-name>\n```\n\nUse a ready-pool lease when the coordinator has hydrated pool capacity:\n\n```sh\ncrabbox pool ready\ncrabbox run --pool \u003Cpool-key> -- pnpm test\ncrabbox run --pool \u003Cpool-key> --pool-return drain -- pnpm test:flaky\n```\n\nUse GitHub Actions hydration when the repository already owns setup in CI:\n\n```sh\ncrabbox warmup --idle-timeout 90m\ncrabbox actions hydrate --id \u003Ccbx_id-or-slug>\ncrabbox run --id \u003Ccbx_id-or-slug> -- pnpm test\n```\n\nUse `--github-runner` only when the workflow needs full GitHub Actions\nsemantics such as repository secrets, OIDC, service containers, job containers,\nor unsupported `uses:` steps:\n\n```sh\ncrabbox actions hydrate --github-runner --id \u003Ccbx_id-or-slug>\n```\n\n## Sync And Fresh Checkouts\n\nUse `--no-sync` only with a provider that supports skipping local file transfer.\nBlacksmith Testbox rejects it: native Testbox runs sync even with an existing\n`--id`. Do not use that path to inspect a remote baseline without uploading local\nedits. Blacksmith also rejects nonblank `prewarm --probe-command` probes and jobs\nwith `noSync: true` before lease acquisition. Put probes in its native workflow\ninstead.\n\nNormal sync transfers tracked files plus non-ignored untracked files, excludes\nignored dependency\u002Fbuild\u002Fcache output, honors `.crabboxignore` and\n`sync.exclude`, seeds the remote checkout from `origin` when possible, and skips\nrsync when the sync fingerprint matches.\n\nUse `crabbox sync-plan` before large runs. Unexpected counts usually mean\nlocal generated churn; update `.crabboxignore` or `sync.exclude` instead of\nforcing huge uploads.\n\n```sh\ncrabbox sync-plan\ncrabbox run --debug --timing-json -- pnpm test\ncrabbox run --full-resync -- pnpm test\n```\n\nUse fresh PR checkout when local dependency churn or dirty sync would confuse\nthe result:\n\n```sh\ncrabbox run --fresh-pr example-org\u002Fmy-app#123 --script .\u002Fscripts\u002Fe2e-smoke.sh\ncrabbox run --fresh-pr 123 --apply-local-patch -- pnpm test\n```\n\n`--fresh-pr` accepts `owner\u002Frepo#number`, GitHub PR URLs, or a numeric PR from\nthe current GitHub origin. Non-GitHub hosts are rejected. Fresh PR checkout is\nan SSH-run sync feature; delegated providers reject it. Native Windows SSH\ntargets are supported.\n\nWhen a warm lease smells stale, prefer `--full-resync` (alias `--fresh-sync`) to\nreset the remote workdir, skip the sync fingerprint fast path, reseed Git when\npossible, and upload the checkout from scratch.\n\n## Scripts, Shells, And Windows Targets\n\nUse plain argv after `--` for one executable. Use `--shell` for multi-statement\nshell snippets, pipes, or shell expansion:\n\n```sh\ncrabbox run --id \u003Clease> -- go test .\u002F...\ncrabbox run --id \u003Clease> --shell 'corepack enable && pnpm install --frozen-lockfile && pnpm test'\n```\n\nUse `--script` for standalone multi-line commands, included in failure bundles.\nOn POSIX SSH leases, it runs a content-hashed copy under `.crabbox\u002Fscripts\u002F`.\nThe remote workdir is `$PWD`; `$0`, `dirname \"$0\"`, and Python's `__file__`\nrefer to the uploaded copy, not the original script directory. Resolve synced\nassets from `$PWD`, or run a repository script in place when it needs adjacent\nfiles: `crabbox run -- .\u002Fscripts\u002Fcheck.sh`.\n\n```sh\ncrabbox run --script .\u002Fscripts\u002Fe2e-smoke.sh --timing-json\nprintf '%s\\n' 'echo CRABBOX_PHASE:test' 'pnpm test' | crabbox run --script-stdin\n```\n\nNative Windows targets use PowerShell and tar-based manifest sync. Prefer plain\nargv for one executable such as `dotnet test`; use `--shell` for multi-statement\nPowerShell and `--script \u003Cfile.ps1>` for longer scripts.\n\n### Hyper-V Windows leases\n\n`hyperv` is a direct Windows-hosted `ssh-lease`\u002F`local-vm` provider for native Windows Generation 2 VHDXs; it supports SSH\u002Fsync, pause\u002Fresume, cleanup, guarded checkpoint `fork`\u002F`restore` (`crabbox checkpoint`), and `--desktop` with WebVNC\u002Fscreenshots (`crabbox desktop proof`). See `docs\u002Fproviders\u002Fhyperv.md`.\n\nNeeds DHCP plus a known local administrator password from trusted user config or `CRABBOX_HYPERV_GUEST_PASSWORD` (never argv\u002Frepo\u002Flogs); PowerShell Direct bootstraps OpenSSH\u002FMinGit. Run with Hyper-V VM\u002Fstorage permissions as the invoking interactive user, never as `LocalSystem`; local `Hyper-V Administrators` membership suffices without elevation. Host session 0 is only an unattended-host convenience against PowerShell Direct credential UI and diverges profile, `PATH`, and SSH known-hosts. Doctor is non-mutating inventory\u002Ffeature proof only: it does not boot the image or validate credentials. Pause uses `Save-VM`.\n\nWindows proof: `crabbox doctor --provider hyperv --target windows --hyperv-image 'C:\\Images\\windows-template.vhdx'`, then `crabbox warmup --provider hyperv --target windows --hyperv-image 'C:\\Images\\windows-template.vhdx' --slug hyperv-win-smoke --timing-json`, `crabbox status --provider hyperv --id hyperv-win-smoke --wait`, a no-sync command, and `crabbox stop --provider hyperv hyperv-win-smoke`.\n\nExercise `pause`\u002F`resume` and `cleanup --dry-run`. Expected blockers: host permissions, wrong image\u002Fgeneration, bad Windows credentials, or DHCP\u002Finternet. Destructive actions require an exact claim; explicitly `--reclaim` recovered VMs.\n\n## Secrets And Environment Forwarding\n\nCrabbox does not forward the whole local environment. Forwarding is name-based:\nonly allowlisted names that are actually set locally or in an allowed profile\ncross the boundary. Avoid allowlisting secret-shaped names unless the run is an\nexplicit live-secret smoke.\n\n```sh\ncrabbox run --allow-env CI,NODE_OPTIONS -- pnpm test\ncrabbox run \\\n  --env-from-profile ~\u002F.project-live.profile \\\n  --allow-env API_TOKEN \\\n  --preflight \\\n  --script .\u002Fscripts\u002Flive-smoke.sh\n```\n\n`--env-from-profile` parses simple `export NAME=value` and `NAME=value` lines\nwithout executing the profile. Crabbox prints redacted presence\u002Flength metadata,\nnot values. POSIX SSH leases can persist a helper for later commands on a lease\nyou control:\n\n```sh\ncrabbox run \\\n  --id \u003Clease> \\\n  --env-from-profile ~\u002F.project-live.profile \\\n  --allow-env API_TOKEN \\\n  --env-helper live \\\n  -- true\ncrabbox run --id \u003Clease> -- .\u002F.crabbox\u002Fenv\u002Flive .\u002Fscripts\u002Flive-smoke.sh\n```\n\nThe generated helper and matching secret profile remain in the remote workdir\nuntil cleanup, lease reset, or `--full-resync`; do not persist helpers on shared\nor untrusted leases.\n\n## Profiles, Presets, Proof, And Results\n\nRepo config can define profiles, presets, doctor requirements, artifact globs,\nrequired artifacts, and proof templates. Use them for stable validation lanes\ninstead of encoding project knowledge in agent prompts.\n\n```sh\ncrabbox run \\\n  --profile live-qa \\\n  --preset qa-live \\\n  --scenario login-regression \\\n  --emit-proof \u002Ftmp\u002Fproof.md \\\n  --stop-after success\n```\n\nUse `--preflight` for a target capability snapshot before the command, not as\nan installer. Use `--preflight-tools` to tune probes:\n\n```sh\ncrabbox run --preflight --preflight-tools node,bun,docker -- bun test\ncrabbox run --preflight --preflight-tools default,uv -- node --test\n```\n\nAttach structured results and proof artifacts when the command emits them:\n\n```sh\ncrabbox run --junit reports\u002Fjunit.xml -- .\u002Fscripts\u002Ftest-with-junit.sh\ncrabbox run --artifact-glob 'reports\u002F**' --require-artifact reports\u002Fsummary.json -- pnpm test:e2e\ncrabbox run --download reports\u002Fsummary.json=.crabbox\u002Flogs\u002Fsummary.json -- pnpm test:e2e\n```\n\n`--require-artifact` fails the run if the remote command exits 0 but the proof\nfile is missing. Keep required artifacts bounded and scrubbed; do not collect\nraw datasets, secrets, credentials, signed URLs, or unredacted customer rows.\n\n## Run Handles And Observability\n\nCoordinator-backed runs print a durable `run_...` handle before leasing starts.\nKeep that run ID in status updates and PR notes.\n\n```sh\ncrabbox history --limit 20\ncrabbox history --lease \u003Ccbx_id-or-slug> --limit 20\ncrabbox attach \u003Crun_id>\ncrabbox attach \u003Crun_id> --after \u003Cseq>\ncrabbox events \u003Crun_id> --after \u003Cseq> --limit 100\ncrabbox events \u003Crun_id> --json\ncrabbox logs \u003Crun_id>\ncrabbox results \u003Crun_id>\n```\n\nUse `--timing-json` on `run`, `warmup`, and `actions hydrate` when a stable\nmachine-readable timing record is needed. Commands can mark subphases by\nprinting markers on stdout or stderr:\n\n```sh\necho CRABBOX_PHASE:install\npnpm install --frozen-lockfile\necho CRABBOX_PHASE:test\npnpm test\n```\n\nOutput events are capped previews. Use `logs` for retained output tails and\n`results` for parsed test summaries.\n\n## Desktop, WebVNC, And UI Proof\n\nCreate desktop\u002Fbrowser leases for visual QA, headed browser automation, or UI\nproof:\n\n```sh\ncrabbox warmup --desktop --browser\ncrabbox warmup --provider aws --os ubuntu:26.04 --desktop --browser --desktop-env wayland\ncrabbox warmup --provider aws --os ubuntu:26.04 --desktop --browser --desktop-env gnome\n```\n\n`ubuntu:26.04` is the default portable Linux OS selector where the provider\ncatalog supports it. Use `--os ubuntu:24.04` only when a test must stay on the\nprevious LTS. Explicit provider image flags still win over `--os`.\n\nFor human demos, prefer WebVNC over native VNC because `crabbox webvnc --open`\npreloads the lease password in the browser fragment:\n\n```sh\ncrabbox webvnc --id \u003Clease> --open --take-control\ncrabbox webvnc status --id \u003Clease>\ncrabbox webvnc reset --id \u003Clease> --open --take-control\ncrabbox vnc --id \u003Clease> --open\n```\n\nFor input automation, use first-class helpers instead of hand-written\n`xdotool`:\n\n```sh\ncrabbox desktop doctor --id \u003Clease>\ncrabbox desktop launch --id \u003Clease> --browser --url https:\u002F\u002Fexample.com --webvnc --open --take-control\ncrabbox desktop click --id \u003Clease> --x 640 --y 420\ncrabbox desktop paste --id \u003Clease> --text \"user@example.com\"\nprintf 'user@example.com' | crabbox desktop paste --id \u003Clease>\ncrabbox desktop type --id \u003Clease> --text \"user+qa@example.com\"\ncrabbox desktop key --id \u003Clease> ctrl+l\ncrabbox screenshot --id \u003Clease> --output desktop.png\n```\n\nWhen desktop\u002FWebVNC hangs, trust the inline rescue output first: `problem:` and\n`rescue:` lines usually name exact next commands such as `webvnc status\u002Freset`,\n`desktop doctor`, or native `vnc --open`.\n\nUse artifacts for UI QA proof instead of committing screenshots or videos to a\nproduct repo branch:\n\n```sh\ncrabbox artifacts collect --id \u003Clease> --all --output artifacts\u002F\u003Cslug>\ncrabbox artifacts publish --dir artifacts\u002F\u003Cslug> --pr \u003Cnumber>\ncrabbox artifacts list \u003Cartifact-manifest-url-or-dir>\ncrabbox artifacts pull \u003Cartifact-manifest-url-or-dir> --output \u002Ftmp\u002F\u003Cslug>-proof\n```\n\n`artifacts publish` uses brokered storage when configured, or explicit S3\u002FR2 \u002F\nCloudflare\u002Flocal hosting flags. Use `--dry-run` before public PR comments when\nreviewing generated Markdown or storage commands.\n\n## Provider Boundaries\n\nSSH-lease providers support the full sync\u002Frun surface when the target supports\nit: scripts, fresh PR checkouts, captures, downloads, Actions hydration, SSH,\nports, WebVNC, code-server, desktop, browser, cache volumes, and cleanup.\n\nDelegated-run providers own command transport. Expect them to reject SSH-run\nfeatures such as `--capture-stdout`, `--capture-stderr`, `--capture-on-fail`,\n`--script`, `--script-stdin`, `--fresh-pr`, local captures, `--download`,\n`--full-resync`, and `--env-helper` unless `crabbox providers --json` and the\nprovider docs advertise the matching capability. `--keep-on-failure` is still\nuseful for one-shot delegated providers that Crabbox would otherwise stop after\na failed command.\n\nModule-runtime delegated providers, such as Cloudflare Dynamic Workers, run\nsource modules rather than Linux shell commands. Use `--script \u003Cfile>` or\n`--script-stdin` for module source; trailing `-- \u003Ccommand>`, SSH, rsync, ports,\nActions hydration, desktop, browser, and code-server do not apply unless the\nprovider explicitly documents them.\n\nUse `--market spot|on-demand` on AWS `warmup` or one-shot `run` when account\nquota or capacity testing needs a temporary market override. An explicit\n`--type` means exact type; Crabbox reports quota\u002Fcapacity\u002Fpolicy failures\ninstead of silently falling back.\n\n## Local And Static Targets\n\nUse `local-container` for fast local proof when the host has Docker or Podman.\n`warmup` creates a container but does not sync; for an interactive synced\ncontainer, use `run --keep --sync-only`:\n\n```sh\ncrabbox run --provider local-container --keep --slug local-smoke --sync-only\neval \"$(crabbox ssh --provider local-container --id local-smoke)\"\n```\n\nPass `--local-container-runtime docker` or `--local-container-runtime podman`\nwhen the engine matters, and keep that flag on reused lease commands such as\n`run --id`, `ssh`, `status`, and `stop`. `crabbox ssh` prints an SSH command;\nuse `eval \"$(crabbox ssh ...)\"` to connect. After login, `cd` into the workdir\nprinted by `run --sync-only`.\n\nUse static SSH for existing machines:\n\n```sh\ncrabbox run --provider ssh --target macos --static-host mac.example.com -- xcodebuild test\ncrabbox run --provider ssh --target windows --windows-mode normal --static-host win.example.com -- dotnet test\n```\n\nStatic hosts are host-managed: Crabbox does not provision or delete them.\n\n## Useful Commands\n\n```sh\ncrabbox providers\ncrabbox providers --json\ncrabbox doctor\ncrabbox config path\ncrabbox config show\ncrabbox whoami\ncrabbox sync-plan\ncrabbox warmup --class beast\ncrabbox prewarm\ncrabbox status --id \u003Clease> --wait\ncrabbox heartbeat --id \u003Clease> --idle-timeout 90m\ncrabbox inspect --id \u003Clease> --json\ncrabbox run --id \u003Clease> --preflight --timing-json -- pnpm test\ncrabbox job list\ncrabbox job run --dry-run \u003Cjob-name>\ncrabbox pool ready\ncrabbox history --lease \u003Clease>\ncrabbox events \u003Crun_id> --json\ncrabbox attach \u003Crun_id>\ncrabbox logs \u003Crun_id>\ncrabbox results \u003Crun_id>\ncrabbox cache stats --id \u003Clease>\ncrabbox cache volumes\ncrabbox ssh --id \u003Clease>\ncrabbox connect \u003Clease>\ncrabbox ports --id \u003Clease> --publish 8080\ncrabbox cp --id \u003Clease> .\u002Fcoverage.xml SANDBOX:\u002Ftmp\u002Fcoverage.xml\ncrabbox webvnc --id \u003Clease> --open\ncrabbox code --id \u003Clease> --open\ncrabbox egress start --id \u003Clease> --profile discord --daemon\ncrabbox desktop doctor --id \u003Clease>\ncrabbox desktop proof --id \u003Clease> --output artifacts\u002F\u003Cslug>-proof -- .\u002Fscripts\u002Fvisual-smoke.sh\ncrabbox artifacts collect --id \u003Clease> --all --output artifacts\u002F\u003Cslug>\ncrabbox artifacts publish --dir artifacts\u002F\u003Cslug> --pr \u003Cnumber> --dry-run\ncrabbox usage --scope org\ncrabbox pause \u003Clease>\ncrabbox resume \u003Clease>\ncrabbox stop \u003Clease>\n```\n\n## Failure Triage\n\n- Provider missing or old CLI: verify `crabbox --help` and `crabbox providers`\n  list the provider, then rebuild or install a current binary.\n- Bad local config: compare `crabbox config show`, pass `--provider ...`\n  explicitly, and run `crabbox doctor`.\n- Sync surprise: run `crabbox sync-plan`, add excludes, then retry with\n  `--debug --timing-json` or `--full-resync`.\n- Raw box missing Node\u002Fpnpm\u002FDocker: use `--preflight`; hydrate first if the\n  repo has an Actions workflow, or include setup in the command\u002Fscript.\n- Command failed: keep the `run_...` handle, inspect `results`, then rerun the\n  focused failing shard\u002Ffile before a full suite.\n- Desktop unhealthy: run `desktop doctor`, then follow `problem:` \u002F `rescue:`\n  output from `webvnc status` or `webvnc reset`.\n- Cleanup uncertain: use `crabbox list`, `crabbox inspect --json`, and only\n  stop leases or provider resources you created.\n- Broker\u002Fauth confusion: use `crabbox doctor`, `crabbox whoami`, and\n  `crabbox config show` before asking for cloud credentials.\n\n## Cleanup\n\nBrokered leases have coordinator-owned idle expiry and local lease claims.\nDefault idle timeout is 30 minutes unless config or flags set a different\nvalue. Still stop boxes you created when done:\n\n```sh\ncrabbox stop \u003Ccbx_id-or-slug>\n```\n\nWhen `crabbox list` prints `orphan=no-active-lease`, treat it as an operator\nreview hint: verify the provider machine is not referenced by an active\ncoordinator lease before deleting anything, especially if `keep=true` is set.\n","# Crabbox\n\nUse Crabbox when a project needs remote proof, larger cloud capacity, a fresh\nPR checkout, a reusable warmed box, GitHub Actions-style setup, durable run\nlogs\u002Fresults, UI proof artifacts, or sync from a dirty local checkout.\n\n## Detect Crabbox\n\n- Treat repo-root `crabbox.yaml` or `.crabbox.yaml` as an intentional signal to\n  use this skill for validation work. `.crabbox.yml` is not a supported config\n  filename.\n- If neither config exists, `command -v crabbox` still identifies an installed\n  CLI. Run `crabbox doctor` before depending on it for remote work.\n- Inspect config before executing it. Detection does not imply permission to\n  expose secrets, bypass command approval, or start paid infrastructure.\n\n## Source Of Truth\n\n- Run Crabbox from the repository root; sync mirrors the current checkout.\n- Treat repo-local `crabbox.yaml` or `.crabbox.yaml` as executable project\n  automation. Review it before remote runs, especially `provider`, `actions`,\n  `jobs`, `profiles`, `env.allow`, artifacts, and cleanup policy.\n- Verify the installed binary before relying on examples:\n  `command -v crabbox && crabbox --version && crabbox --help | sed -n '1,120p'`.\n- Use `crabbox providers` or `crabbox providers --json` for the current\n  provider\u002Fcapability matrix; provider docs can lag the compiled binary.\n- Use `crabbox doctor` for live readiness checks and `crabbox config show` to\n  inspect merged config without printing secrets.\n- Prefer local targeted tests for tight edit loops. Move to Crabbox for broad\n  suites, package-heavy checks, Docker\u002FE2E\u002Flive-provider proof, cross-OS proof,\n  UI proof, or commands that bog down the local machine.\n\n## Auth And Config\n\nBrokered operation needs a coordinator URL and token. First login usually needs\nan explicit broker URL:\n\n```sh\ncrabbox login --url \u003Cbroker-url>\ncrabbox whoami\ncrabbox doctor\n```\n\nAfter `broker.url` is configured, `crabbox login` can reuse it. Trusted operator\nautomation can store a shared token without putting it on argv:\n\n```sh\nprintf '%s' \"$CRABBOX_COORDINATOR_TOKEN\" |\n  crabbox login --url \u003Cbroker-url> --provider aws --token-stdin\n```\n\nConfig precedence is `flags > env > repo config > user config > defaults`.\nDefault user config is `~\u002FLibrary\u002FApplication Support\u002Fcrabbox\u002Fconfig.yaml` on\nmacOS, `~\u002F.config\u002Fcrabbox\u002Fconfig.yaml` on Linux, or\n`$XDG_CONFIG_HOME\u002Fcrabbox\u002Fconfig.yaml` when set. `crabbox config path` prints\nthe active user config path.\n\nKeep provider and broker tokens out of repo config and command arguments. Use\nenvironment variables, a credential store, coordinator-managed secrets, or a\nshort-lived token command.\n\n## Choose The Remote Surface\n\n- `crabbox run -- \u003Ccommand>`: one command on a fresh or reused box.\n- `crabbox warmup`: create a reusable lease and run commands later with `--id`.\n- `crabbox prewarm`: warm a reusable lease and hydrate it from configured\n  GitHub Actions.\n- `crabbox job run \u003Cname>`: use a repo-local named flow that expands to\n  warmup, optional hydration, run, and stop.\n- `crabbox run --pool \u003Ckey>`: borrow a hydrated broker ready-pool lease, run,\n  then return\u002Fdrain\u002Frelease it according to `--pool-return`.\n- `crabbox run --fresh-pr ...`: ignore local sync and check out a GitHub PR on\n  the remote; add `--apply-local-patch` to test local uncommitted changes on\n  top of that PR.\n- `crabbox run --provider ssh`: use an existing macOS, Linux, or Windows host.\n- `crabbox warmup --desktop --browser`: provision a visible desktop\u002Fbrowser for\n  UI testing, WebVNC, screenshots, and artifacts.\n\nIf remote proof is blocked, name the missing capability precisely: auth,\ncoordinator, capacity, provider support, target OS, hydration, secret access,\nartifact storage, desktop support, or a delegated-provider limitation.\n\n## Common Remote Proof\n\nOne-shot command:\n\n```sh\ncrabbox run --preflight --timing-json -- pnpm test\n```\n\nWarm and reuse a lease:\n\n```sh\ncrabbox warmup --class beast --idle-timeout 90m\ncrabbox status --id \u003Ccbx_id-or-slug> --wait\ncrabbox run --id \u003Ccbx_id-or-slug> -- pnpm test:changed\ncrabbox run --id \u003Ccbx_id-or-slug> --full-resync -- pnpm test:changed\ncrabbox stop \u003Ccbx_id-or-slug>\n```\n\nUse a repo-local job when configured:\n\n```sh\ncrabbox job list\ncrabbox job run --dry-run \u003Cjob-name>\ncrabbox job run \u003Cjob-name>\ncrabbox job run --id \u003Ccbx_id-or-slug> \u003Cjob-name>\n```\n\nUse a ready-pool lease when the coordinator has hydrated pool capacity:\n\n```sh\ncrabbox pool ready\ncrabbox run --pool \u003Cpool-key> -- pnpm test\ncrabbox run --pool \u003Cpool-key> --pool-return drain -- pnpm test:flaky\n```\n\nUse GitHub Actions hydration when the repository already owns setup in CI:\n\n```sh\ncrabbox warmup --idle-timeout 90m\ncrabbox actions hydrate --id \u003Ccbx_id-or-slug>\ncrabbox run --id \u003Ccbx_id-or-slug> -- pnpm test\n```\n\nUse `--github-runner` only when the workflow needs full GitHub Actions\nsemantics such as repository secrets, OIDC, service containers, job containers,\nor unsupported `uses:` steps:\n\n```sh\ncrabbox actions hydrate --github-runner --id \u003Ccbx_id-or-slug>\n```\n\n## Sync And Fresh Checkouts\n\nUse `--no-sync` only with a provider that supports skipping local file transfer.\nBlacksmith Testbox rejects it: native Testbox runs sync even with an existing\n`--id`. Do not use that path to inspect a remote baseline without uploading local\nedits. Blacksmith also rejects nonblank `prewarm --probe-command` probes and jobs\nwith `noSync: true` before lease acquisition. Put probes in its native workflow\ninstead.\n\nNormal sync transfers tracked files plus non-ignored untracked files, excludes\nignored dependency\u002Fbuild\u002Fcache output, honors `.crabboxignore` and\n`sync.exclude`, seeds the remote checkout from `origin` when possible, and skips\nrsync when the sync fingerprint matches.\n\nUse `crabbox sync-plan` before large runs. Unexpected counts usually mean\nlocal generated churn; update `.crabboxignore` or `sync.exclude` instead of\nforcing huge uploads.\n\n```sh\ncrabbox sync-plan\ncrabbox run --debug --timing-json -- pnpm test\ncrabbox run --full-resync -- pnpm test\n```\n\nUse fresh PR checkout when local dependency churn or dirty sync would confuse\nthe result:\n\n```sh\ncrabbox run --fresh-pr example-org\u002Fmy-app#123 --script .\u002Fscripts\u002Fe2e-smoke.sh\ncrabbox run --fresh-pr 123 --apply-local-patch -- pnpm test\n```\n\n`--fresh-pr` accepts `owner\u002Frepo#number`, GitHub PR URLs, or a numeric PR from\nthe current GitHub origin. Non-GitHub hosts are rejected. Fresh PR checkout is\nan SSH-run sync feature; delegated providers reject it. Native Windows SSH\ntargets are supported.\n\nWhen a warm lease smells stale, prefer `--full-resync` (alias `--fresh-sync`) to\nreset the remote workdir, skip the sync fingerprint fast path, reseed Git when\npossible, and upload the checkout from scratch.\n\n## Scripts, Shells, And Windows Targets\n\nUse plain argv after `--` for one executable. Use `--shell` for multi-statement\nshell snippets, pipes, or shell expansion:\n\n```sh\ncrabbox run --id \u003Clease> -- go test .\u002F...\ncrabbox run --id \u003Clease> --shell 'corepack enable && pnpm install --frozen-lockfile && pnpm test'\n```\n\nUse `--script` for standalone multi-line commands, included in failure bundles.\nOn POSIX SSH leases, it runs a content-hashed copy under `.crabbox\u002Fscripts\u002F`.\nThe remote workdir is `$PWD`; `$0`, `dirname \"$0\"`, and Python's `__file__`\nrefer to the uploaded copy, not the original script directory. Resolve synced\nassets from `$PWD`, or run a repository script in place when it needs adjacent\nfiles: `crabbox run -- .\u002Fscripts\u002Fcheck.sh`.\n\n```sh\ncrabbox run --script .\u002Fscripts\u002Fe2e-smoke.sh --timing-json\nprintf '%s\\n' 'echo CRABBOX_PHASE:test' 'pnpm test' | crabbox run --script-stdin\n```\n\nNative Windows targets use PowerShell and tar-based manifest sync. Prefer plain\nargv for one executable such as `dotnet test`; use `--shell` for multi-statement\nPowerShell and `--script \u003Cfile.ps1>` for longer scripts.\n\n### Hyper-V Windows leases\n\n`hyperv` is a direct Windows-hosted `ssh-lease`\u002F`local-vm` provider for native Windows Generation 2 VHDXs; it supports SSH\u002Fsync, pause\u002Fresume, cleanup, guarded checkpoint `fork`\u002F`restore` (`crabbox checkpoint`), and `--desktop` with WebVNC\u002Fscreenshots (`crabbox desktop proof`). See `docs\u002Fproviders\u002Fhyperv.md`.\n\nNeeds DHCP plus a known local administrator password from trusted user config or `CRABBOX_HYPERV_GUEST_PASSWORD` (never argv\u002Frepo\u002Flogs); PowerShell Direct bootstraps OpenSSH\u002FMinGit. Run with Hyper-V VM\u002Fstorage permissions as the invoking interactive user, never as `LocalSystem`; local `Hyper-V Administrators` membership suffices without elevation. Host session 0 is only an unattended-host convenience against PowerShell Direct credential UI and diverges profile, `PATH`, and SSH known-hosts. Doctor is non-mutating inventory\u002Ffeature proof only: it does not boot the image or validate credentials. Pause uses `Save-VM`.\n\nWindows proof: `crabbox doctor --provider hyperv --target windows --hyperv-image 'C:\\Images\\windows-template.vhdx'`, then `crabbox warmup --provider hyperv --target windows --hyperv-image 'C:\\Images\\windows-template.vhdx' --slug hyperv-win-smoke --timing-json`, `crabbox status --provider hyperv --id hyperv-win-smoke --wait`, a no-sync command, and `crabbox stop --provider hyperv hyperv-win-smoke`.\n\nExercise `pause`\u002F`resume` and `cleanup --dry-run`. Expected blockers: host permissions, wrong image\u002Fgeneration, bad Windows credentials, or DHCP\u002Finternet. Destructive actions require an exact claim; explicitly `--reclaim` recovered VMs.\n\n## Secrets And Environment Forwarding\n\nCrabbox does not forward the whole local environment. Forwarding is name-based:\nonly allowlisted names that are actually set locally or in an allowed profile\ncross the boundary. Avoid allowlisting secret-shaped names unless the run is an\nexplicit live-secret smoke.\n\n```sh\ncrabbox run --allow-env CI,NODE_OPTIONS -- pnpm test\ncrabbox run \\\n  --env-from-profile ~\u002F.project-live.profile \\\n  --allow-env API_TOKEN \\\n  --preflight \\\n  --script .\u002Fscripts\u002Flive-smoke.sh\n```\n\n`--env-from-profile` parses simple `export NAME=value` and `NAME=value` lines\nwithout executing the profile. Crabbox prints redacted presence\u002Flength metadata,\nnot values. POSIX SSH leases can persist a helper for later commands on a lease\nyou control:\n\n```sh\ncrabbox run \\\n  --id \u003Clease> \\\n  --env-from-profile ~\u002F.project-live.profile \\\n  --allow-env API_TOKEN \\\n  --env-helper live \\\n  -- true\ncrabbox run --id \u003Clease> -- .\u002F.crabbox\u002Fenv\u002Flive .\u002Fscripts\u002Flive-smoke.sh\n```\n\nThe generated helper and matching secret profile remain in the remote workdir\nuntil cleanup, lease reset, or `--full-resync`; do not persist helpers on shared\nor untrusted leases.\n\n## Profiles, Presets, Proof, And Results\n\nRepo config can define profiles, presets, doctor requirements, artifact globs,\nrequired artifacts, and proof templates. Use them for stable validation lanes\ninstead of encoding project knowledge in agent prompts.\n\n```sh\ncrabbox run \\\n  --profile live-qa \\\n  --preset qa-live \\\n  --scenario login-regression \\\n  --emit-proof \u002Ftmp\u002Fproof.md \\\n  --stop-after success\n```\n\nUse `--preflight` for a target capability snapshot before the command, not as\nan installer. Use `--preflight-tools` to tune probes:\n\n```sh\ncrabbox run --preflight --preflight-tools node,bun,docker -- bun test\ncrabbox run --preflight --preflight-tools default,uv -- node --test\n```\n\nAttach structured results and proof artifacts when the command emits them:\n\n```sh\ncrabbox run --junit reports\u002Fjunit.xml -- .\u002Fscripts\u002Ftest-with-junit.sh\ncrabbox run --artifact-glob 'reports\u002F**' --require-artifact reports\u002Fsummary.json -- pnpm test:e2e\ncrabbox run --download reports\u002Fsummary.json=.crabbox\u002Flogs\u002Fsummary.json -- pnpm test:e2e\n```\n\n`--require-artifact` fails the run if the remote command exits 0 but the proof\nfile is missing. Keep required artifacts bounded and scrubbed; do not collect\nraw datasets, secrets, credentials, signed URLs, or unredacted customer rows.\n\n## Run Handles And Observability\n\nCoordinator-backed runs print a durable `run_...` handle before leasing starts.\nKeep that run ID in status updates and PR notes.\n\n```sh\ncrabbox history --limit 20\ncrabbox history --lease \u003Ccbx_id-or-slug> --limit 20\ncrabbox attach \u003Crun_id>\ncrabbox attach \u003Crun_id> --after \u003Cseq>\ncrabbox events \u003Crun_id> --after \u003Cseq> --limit 100\ncrabbox events \u003Crun_id> --json\ncrabbox logs \u003Crun_id>\ncrabbox results \u003Crun_id>\n```\n\nUse `--timing-json` on `run`, `warmup`, and `actions hydrate` when a stable\nmachine-readable timing record is needed. Commands can mark subphases by\nprinting markers on stdout or stderr:\n\n```sh\necho CRABBOX_PHASE:install\npnpm install --frozen-lockfile\necho CRABBOX_PHASE:test\npnpm test\n```\n\nOutput events are capped previews. Use `logs` for retained output tails and\n`results` for parsed test summaries.\n\n## Desktop, WebVNC, And UI Proof\n\nCreate desktop\u002Fbrowser leases for visual QA, headed browser automation, or UI\nproof:\n\n```sh\ncrabbox warmup --desktop --browser\ncrabbox warmup --provider aws --os ubuntu:26.04 --desktop --browser --desktop-env wayland\ncrabbox warmup --provider aws --os ubuntu:26.04 --desktop --browser --desktop-env gnome\n```\n\n`ubuntu:26.04` is the default portable Linux OS selector where the provider\ncatalog supports it. Use `--os ubuntu:24.04` only when a test must stay on the\nprevious LTS. Explicit provider image flags still win over `--os`.\n\nFor human demos, prefer WebVNC over native VNC because `crabbox webvnc --open`\npreloads the lease password in the browser fragment:\n\n```sh\ncrabbox webvnc --id \u003Clease> --open --take-control\ncrabbox webvnc status --id \u003Clease>\ncrabbox webvnc reset --id \u003Clease> --open --take-control\ncrabbox vnc --id \u003Clease> --open\n```\n\nFor input automation, use first-class helpers instead of hand-written\n`xdotool`:\n\n```sh\ncrabbox desktop doctor --id \u003Clease>\ncrabbox desktop launch --id \u003Clease> --browser --url https:\u002F\u002Fexample.com --webvnc --open --take-control\ncrabbox desktop click --id \u003Clease> --x 640 --y 420\ncrabbox desktop paste --id \u003Clease> --text \"user@example.com\"\nprintf 'user@example.com' | crabbox desktop paste --id \u003Clease>\ncrabbox desktop type --id \u003Clease> --text \"user+qa@example.com\"\ncrabbox desktop key --id \u003Clease> ctrl+l\ncrabbox screenshot --id \u003Clease> --output desktop.png\n```\n\nWhen desktop\u002FWebVNC hangs, trust the inline rescue output first: `problem:` and\n`rescue:` lines usually name exact next commands such as `webvnc status\u002Freset`,\n`desktop doctor`, or native `vnc --open`.\n\nUse artifacts for UI QA proof instead of committing screenshots or videos to a\nproduct repo branch:\n\n```sh\ncrabbox artifacts collect --id \u003Clease> --all --output artifacts\u002F\u003Cslug>\ncrabbox artifacts publish --dir artifacts\u002F\u003Cslug> --pr \u003Cnumber>\ncrabbox artifacts list \u003Cartifact-manifest-url-or-dir>\ncrabbox artifacts pull \u003Cartifact-manifest-url-or-dir> --output \u002Ftmp\u002F\u003Cslug>-proof\n```\n\n`artifacts publish` uses brokered storage when configured, or explicit S3\u002FR2 \u002F\nCloudflare\u002Flocal hosting flags. Use `--dry-run` before public PR comments when\nreviewing generated Markdown or storage commands.\n\n## Provider Boundaries\n\nSSH-lease providers support the full sync\u002Frun surface when the target supports\nit: scripts, fresh PR checkouts, captures, downloads, Actions hydration, SSH,\nports, WebVNC, code-server, desktop, browser, cache volumes, and cleanup.\n\nDelegated-run providers own command transport. Expect them to reject SSH-run\nfeatures such as `--capture-stdout`, `--capture-stderr`, `--capture-on-fail`,\n`--script`, `--script-stdin`, `--fresh-pr`, local captures, `--download`,\n`--full-resync`, and `--env-helper` unless `crabbox providers --json` and the\nprovider docs advertise the matching capability. `--keep-on-failure` is still\nuseful for one-shot delegated providers that Crabbox would otherwise stop after\na failed command.\n\nModule-runtime delegated providers, such as Cloudflare Dynamic Workers, run\nsource modules rather than Linux shell commands. Use `--script \u003Cfile>` or\n`--script-stdin` for module source; trailing `-- \u003Ccommand>`, SSH, rsync, ports,\nActions hydration, desktop, browser, and code-server do not apply unless the\nprovider explicitly documents them.\n\nUse `--market spot|on-demand` on AWS `warmup` or one-shot `run` when account\nquota or capacity testing needs a temporary market override. An explicit\n`--type` means exact type; Crabbox reports quota\u002Fcapacity\u002Fpolicy failures\ninstead of silently falling back.\n\n## Local And Static Targets\n\nUse `local-container` for fast local proof when the host has Docker or Podman.\n`warmup` creates a container but does not sync; for an interactive synced\ncontainer, use `run --keep --sync-only`:\n\n```sh\ncrabbox run --provider local-container --keep --slug local-smoke --sync-only\neval \"$(crabbox ssh --provider local-container --id local-smoke)\"\n```\n\nPass `--local-container-runtime docker` or `--local-container-runtime podman`\nwhen the engine matters, and keep that flag on reused lease commands such as\n`run --id`, `ssh`, `status`, and `stop`. `crabbox ssh` prints an SSH command;\nuse `eval \"$(crabbox ssh ...)\"` to connect. After login, `cd` into the workdir\nprinted by `run --sync-only`.\n\nUse static SSH for existing machines:\n\n```sh\ncrabbox run --provider ssh --target macos --static-host mac.example.com -- xcodebuild test\ncrabbox run --provider ssh --target windows --windows-mode normal --static-host win.example.com -- dotnet test\n```\n\nStatic hosts are host-managed: Crabbox does not provision or delete them.\n\n## Useful Commands\n\n```sh\ncrabbox providers\ncrabbox providers --json\ncrabbox doctor\ncrabbox config path\ncrabbox config show\ncrabbox whoami\ncrabbox sync-plan\ncrabbox warmup --class beast\ncrabbox prewarm\ncrabbox status --id \u003Clease> --wait\ncrabbox heartbeat --id \u003Clease> --idle-timeout 90m\ncrabbox inspect --id \u003Clease> --json\ncrabbox run --id \u003Clease> --preflight --timing-json -- pnpm test\ncrabbox job list\ncrabbox job run --dry-run \u003Cjob-name>\ncrabbox pool ready\ncrabbox history --lease \u003Clease>\ncrabbox events \u003Crun_id> --json\ncrabbox attach \u003Crun_id>\ncrabbox logs \u003Crun_id>\ncrabbox results \u003Crun_id>\ncrabbox cache stats --id \u003Clease>\ncrabbox cache volumes\ncrabbox ssh --id \u003Clease>\ncrabbox connect \u003Clease>\ncrabbox ports --id \u003Clease> --publish 8080\ncrabbox cp --id \u003Clease> .\u002Fcoverage.xml SANDBOX:\u002Ftmp\u002Fcoverage.xml\ncrabbox webvnc --id \u003Clease> --open\ncrabbox code --id \u003Clease> --open\ncrabbox egress start --id \u003Clease> --profile discord --daemon\ncrabbox desktop doctor --id \u003Clease>\ncrabbox desktop proof --id \u003Clease> --output artifacts\u002F\u003Cslug>-proof -- .\u002Fscripts\u002Fvisual-smoke.sh\ncrabbox artifacts collect --id \u003Clease> --all --output artifacts\u002F\u003Cslug>\ncrabbox artifacts publish --dir artifacts\u002F\u003Cslug> --pr \u003Cnumber> --dry-run\ncrabbox usage --scope org\ncrabbox pause \u003Clease>\ncrabbox resume \u003Clease>\ncrabbox stop \u003Clease>\n```\n\n## Failure Triage\n\n- Provider missing or old CLI: verify `crabbox --help` and `crabbox providers`\n  list the provider, then rebuild or install a current binary.\n- Bad local config: compare `crabbox config show`, pass `--provider ...`\n  explicitly, and run `crabbox doctor`.\n- Sync surprise: run `crabbox sync-plan`, add excludes, then retry with\n  `--debug --timing-json` or `--full-resync`.\n- Raw box missing Node\u002Fpnpm\u002FDocker: use `--preflight`; hydrate first if the\n  repo has an Actions workflow, or include setup in the command\u002Fscript.\n- Command failed: keep the `run_...` handle, inspect `results`, then rerun the\n  focused failing shard\u002Ffile before a full suite.\n- Desktop unhealthy: run `desktop doctor`, then follow `problem:` \u002F `rescue:`\n  output from `webvnc status` or `webvnc reset`.\n- Cleanup uncertain: use `crabbox list`, `crabbox inspect --json`, and only\n  stop leases or provider resources you created.\n- Broker\u002Fauth confusion: use `crabbox doctor`, `crabbox whoami`, and\n  `crabbox config show` before asking for cloud credentials.\n\n## Cleanup\n\nBrokered leases have coordinator-owned idle expiry and local lease claims.\nDefault idle timeout is 30 minutes unless config or flags set a different\nvalue. Still stop boxes you created when done:\n\n```sh\ncrabbox stop \u003Ccbx_id-or-slug>\n```\n\nWhen `crabbox list` prints `orphan=no-active-lease`, treat it as an operator\nreview hint: verify the provider machine is not referenced by an active\ncoordinator lease before deleting anything, especially if `keep=true` is set.\n",{"name":5,"license":14,"description":7},"main","a2f1c03591d38f5e6e6374ab5a6f98e4d0e8c291",".agents\u002Fskills\u002Fcrabbox",214,"https:\u002F\u002Fgithub.com\u002Fopenclaw\u002Fcrabbox","http:\u002F\u002Fcrabbox.sh","https:\u002F\u002Fgithub.com\u002Fopenclaw","https:\u002F\u002Fopenclaw.ai","Your personal, open source AI assistant.","2026-11-14 15:45:19",{"source":8,"skillName":5,"commands":53,"prompt":63,"zipAvailable":64},[54,57,60],{"tool":55,"command":56},"npx","npx skills add openclaw\u002Fcrabbox --skill crabbox",{"tool":58,"command":59},"bunx","bunx skills add openclaw\u002Fcrabbox --skill crabbox",{"tool":61,"command":62},"pnpm","pnpm dlx skills add openclaw\u002Fcrabbox --skill crabbox","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fopenclaw\u002Fcrabbox\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fcrabbox\u002FSKILL.md",true,[],[67,72,80,85],{"skillNo":68,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":69,"categories":70,"keywords":71,"publishedAt":37},"01M698RPYZ3PW2VXH2578N305A","https:\u002F\u002Fgithub.com\u002Fopenclaw\u002Fcrabbox\u002Fblob\u002Fmain\u002Fskills\u002Fcrabbox\u002FSKILL.md",[],[5,20,19,21,22,23,24,25,26,27,18,28,29,30,31,32,33,34,35,36],{"skillNo":73,"name":74,"nameZh":6,"description":75,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":76,"categories":77,"keywords":78,"publishedAt":37},"01M698RNP92DV568MJNGWPG1NT","crabbox-quickstart","First contact with Crabbox: run your repository's tests inside a disposable Docker or Podman container on your own machine, no account and no cloud spend, then stop the box. Use when someone asks what Crabbox is or how to try it, wants a throwaway sandbox for a repo with no crabbox.yaml yet, or is about to run crabbox init here; hand off to the crabbox skill for config that already exists, leased remote machines, jobs, secrets, or artifacts.","https:\u002F\u002Fgithub.com\u002Fopenclaw\u002Fcrabbox\u002Fblob\u002Fmain\u002Fskills\u002Fcrabbox-quickstart\u002FSKILL.md",[],[79,5],"crabbox quickstart",{"skillNo":81,"name":74,"nameZh":6,"description":75,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":82,"categories":83,"keywords":84,"publishedAt":37},"01M698RK21XQE4P6449VZVDD2Z","https:\u002F\u002Fgithub.com\u002Fopenclaw\u002Fcrabbox\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fcrabbox-quickstart\u002FSKILL.md",[],[79,5],{"skillNo":86,"name":87,"nameZh":6,"description":88,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":89,"categories":90,"keywords":96,"publishedAt":37},"01M698RHGQVA33P1C6725PJJ56","autoreview","Structured code review through the shared OpenClaw agent-skills installation.","https:\u002F\u002Fgithub.com\u002Fopenclaw\u002Fcrabbox\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fautoreview\u002FSKILL.md",[91],{"categoryNo":92,"categoryName":93,"taxonomyType":94,"taxonomyTypeDesc":95},"01JBSEEDCAT000000000000007","代码审查","SCENARIO","使用场景",[87,97,98,9],"code review","review"]