Agent skill · software engineering · aiskillstore
local-dev-server
Local dev server management — start, stop, clean restart, fix cache corruption, port conflicts. Use this skill whenever the dev server needs launching or is misbehaving.
Why this skill is useful
Adds executable scripts for managing a local dev server, including cache cleaning and process management that the AI wouldn't reliably generate on its own.
What it needs
Requires next, pm2 installed locally. About 2k tokens when loaded. Last updated 2026-08-07. 405 stars on the source repository.
What this skill does
Local Dev Server When to Use Starting/stopping dev server "Address already in use" errors Infinite loading spinner / broken pages after build .next cache corruption (vendor-chunks ENOENT, 404 on static chunks) Server crashes and needs restart After major code changes or branch switches Standard Start (Clean) Always prefer a clean start to avoid stale cache issues: First page load after clean start takes ~20-30s to compile. This is normal. Quick Restart (No Cache Clean) Only use when you know the cache is fine (small code edits): PM2 (Persistent Server) For long sessions where server should auto-restart on crash: Troubleshooting Infinite spinner / blank page Port already in use API returns 401 when it shouldn't Check browser has valid session cookies Try logging out and back in at /auth/signin The API auth middleware reads cookies — curl without cookies will always 401 Vendor-chunks ENOENT / 404 on static chunks Verification Checklist After starting the server, verify: 1. curl -s -o /dev/null -w "%{httpcode}" http://localhost:3030 returns 200 or 307 2. Navigate to target page in browser 3. Check server logs for compilation errors Key URLs Homepage: http://localhost:3030 Admin: http://localhost:3030/admin Data Health: http://localhost:3030/admin/data-health Storytellers: http://localhost:3030/admin/storytellers Related Skills deployment-workflow — Production deployment supabase-connection — Database setup
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aiskillstore/local-dev-server