
Repair Dev Workspace
Starts, reseeds and verifies isolated dev services, including their ports and health.
Install
npx skills add paperclipai/paperclip --skill paperclip-dev-workspace-run-verify-fix -g -a claude-code -y- Repository
- paperclipai/paperclip110k
- Category
- DevOps
- Updated
- 3d ago
- License
- MIT
- Context cost
- Mediumabout 3,000 tokens
- Runs scripts
- No, instructions only
What it does
Run, verify, reseed, and repair Paperclip isolated dev workspace services. Use when asked to start or fix a managed project/worktree service and prove health, login readiness, cloned data, runtime visibility, and correct port ownership.
Paperclip Dev Workspace Run / Verify / Fix
This skill is for Paperclip-specific development workspaces whose service is
started through project execution workspace runtime services, typically a
worktree service such as paperclip-dev.
Success means all of these are true:
- the service was started through the normal managed runtime path, not a detached workaround
- the worktree database is a full bootstrapped isolated clone of the primary instance database
/api/healthreturnsstatus: okandbootstrapStatus: ready- the root page returns
200and does not show the first-admin setup gate - the board user can log in with their normal dev credentials
- the app shows populated cloned data, not only a manually copied auth user
- the main control plane shows the service as
running/healthywith the expected URL - the served workspace app also knows about that service and shows it as
running/healthy - the process that owns the service port really belongs to the target
workspace:
readlink /proc/<pid>/cwdresolves inside the target worktree, not a sibling workspace
If any item fails, keep fixing. Do not mark the issue done because one probe passed.

