Menu
This skill verifies the local Pronghorn stack by checking frontend, API health endpoint, and local PostgreSQL readiness.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
This skill will guide you through the process of setting up PostgreSQL on your local machine.
This skill will guide you through running the PostgreSQL schema migration for Pronghorn development.
This skill will guide you through setting up the local API server for Pronghorn development, including installing dependencies, configuring environment variables, and starting the server.
This skill will guide you through setting up the local frontend for Pronghorn development, including installing dependencies, configuring .env.local, and starting the Vite development server.
Automates Docker Compose full-stack workflows for local Pronghorn development, including build prerequisites, startup, verification, logs, stop, and reset operations.
This skill will guide you through verifying that your deployed AI models are accessible and functioning correctly.
| name | 06.verify-local-stack |
| description | This skill verifies the local Pronghorn stack by checking frontend, API health endpoint, and local PostgreSQL readiness. |
| argument-hint | Please verify my local stack and report what is passing or failing. |
| compatibility | ["linux","macos","windows"] |
| license | MIT |
| user-invokable | true |
This skill implements step 6 from LOCAL_DEVELOPMENT.md and helps confirm your local stack is operational.
Before verification, ensure setup steps are completed:
Expected local endpoints:
http://localhost:8080http://localhost:3001/healthpronghorn-dbAutomated checks:
http://localhost:8080)http://localhost:3001/health)pg_isready (if Docker is available)Manual checks (from step 6):
Use wrapper scripts to auto-detect OS and run the correct implementation.
Note for maintainers: verify-stack.ps1 and verify-stack.sh are preferred user entrypoints. Verify-LocalStack.ps1 and verify-local-stack.sh are internal implementation scripts called by wrappers.
Set-Location .github/skills/06.verify-local-stack/scripts
.\verify-stack.ps1
cd .github/skills/06.verify-local-stack/scripts
bash ./verify-stack.sh
If you want to verify exactly as described in LOCAL_DEVELOPMENT.md:
http://localhost:8080 in your browser.Expected state:
✅ Frontend: http://localhost:8080
✅ API: http://localhost:3001
✅ Database: localhost:5432
✅ Swagger: http://localhost:3001/api-docs
pronghorn-db exists and pg_isready returns ready✅ Frontend is reachable: http://localhost:8080
✅ API health is reachable: http://localhost:3001/health
✅ PostgreSQL container is accepting connections: pronghorn-db
✅ Stack verification passed.
| Failure | Cause | Action |
|---|---|---|
| Frontend unreachable | Vite not running or wrong port | Start frontend from repo root: npm run dev; if Vite auto-starts on 8081, free 8080 and restart |
| API health unreachable | API not running or env/config issue | Start API from app/backend/: npm run dev (or npm --prefix app/backend run dev) |
| DB container not running | Docker container stopped | docker start pronghorn-db |
| DB readiness fails | DB up but not ready/migrated | Wait and retry; re-run schema migration (step 3) |
| CORS/login issues in browser | Auth/redirect mismatch | Confirm app registration and VITE_AZURE_* values |
After successful stack verification: