How do I install the Rork Local Dev skill?

Run npx skillmds@latest add rorkai/rork-local-dev in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Rork Local Dev skill do?

Build, restart, and smoke-test the rork-local server when developing this repo. Use after changing anything under src/, before committing server changes, or when the dev server at localhost:3131 misbehaves. It is listed under Coding & Dev Tools on SkillMD.

Is Rork Local Dev safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Rork Local Dev?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Rork Local Dev free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Rork Local Dev?

rorkai (@rorkai) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Rork Local Dev by rorkai — Agent Skill

Name: Rork Local Dev
Author: rorkai

File contents

rork-local Development

Use this project-scoped skill when working on rork-local itself. End-user usage (driving a running server to publish or capture screenshots) lives in the public skills/rork-local skill; do not add internal dev workflows there.

Workflow

After editing src/, rebuild and typecheck:
```
bun run build
```
Static public/ changes need no rebuild or restart.
Restart the dev server. It normally runs under pm2:
```
npx pm2 restart rork-local --update-env
```
If it isn't registered yet:
```
ASC_BIN=/path/to/asc npx pm2 start dist/cli.js --name rork-local
```
serve-sim's native helper occasionally segfaults right after startup; pm2 restarts it automatically — wait a few seconds before declaring failure.
Smoke-test from the repo root:
```
sh .codex/skills/rork-local-dev/scripts/smoke.sh          # default port 3131
PORT=3199 sh .codex/skills/rork-local-dev/scripts/smoke.sh
```
It checks /, /.sim, /api/status, and a screenshot capture/delete round-trip. All four must pass before committing server changes.
If you changed an endpoint, flag, or response shape, update skills/rork-local/SKILL.md and the README API table in the same change.

Frequently asked questions

Rork Local Dev