# Onboard

> Gets a first-time or broken local dev environment runnable. Use after clone, when install fails, when the user asks to set up the project, or before first implement. Complements discover-project with hands-on setup steps.

- Skill: `axidify/onboard` (Agent Skill)
- Install (CLI): `npx skillmds@latest add axidify/onboard`
- Raw SKILL.md: https://api.skillmd.com/api/skills/axidify/onboard/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: Axidify (https://skillmd.com/u/axidify)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/axidify/onboard

---


# Onboard (local environment)

Run **discover-project** first if stack and scripts are still unknown.

## Checklist

1. **Prerequisites** — Node/Python/Rust/Docker versions from README or `.tool-versions` / `engines`
2. **Install deps** — use the project's package manager (`pnpm install`, `pip install -e .`, etc.)
3. **Environment** — copy `.env.example` → `.env`; list required vars; never invent secret values
4. **Services** — start DB/cache via documented Docker compose or local instructions
5. **Migrations / seed** — run only if documented (`prisma migrate`, `rake db:setup`, etc.)
6. **Dev server** — run the documented dev command; confirm URL and port
7. **Smoke test** — run the smallest documented test or lint command
8. **Report** — what works, what failed, exact errors, what the user must supply manually

## Rules

- Follow README and CONTRIBUTING over assumptions
- Do not commit `.env` or secrets
- If setup is blocked (missing credentials, paid API keys), state the blocker clearly

When runnable, hand off to **plan** or **implement** as needed.

## Related skills

- **discover-project** — run first if the stack is unknown
- **test** — confirm smoke tests pass
- **ui-browser-check** — verify UI after dev server is up