Onboarding Guide
Moves the entire local development setup and onboarding guide out of Notion and into a Claude skill so new team members can be onboarded by Claude directly.
Before & after
Same prompt, same agent — the only difference is the skill.
I'd be happy to help you set up your local environment! There are quite a few things to install and configure depending on your tech stack, but I can guide you through the process. Generally, you'll need to install your language runtimes, set up databases, configure environment variables, and ensure all services are running. The exact steps will vary depending on your specific setup. Would you like me to walk through each component, or do you have specific questions about particular parts of the setup?
LOCAL DEV SETUP GUIDE FOUNDATION • Node.js 18+ via nvm (avoids version conflicts) • PostgreSQL 14+ local instance (use docker-compose postgres service) • Redis 6+ for cache/session store • Git configured with your SSH key ENV SETUP • Copy .env.local.example to .env.local • Set DATABASE_URL to your local Postgres instance: postgres://user:pass@localhost:5432/devdb • Set REDIS_URL to localhost:6379 • Leave auth tokens empty for local testing (mock mode) DEPENDENCY INSTALL • npm ci (exact versions from package-lock.json) • prisma db push (applies migrations without reset) VERIFICATION • npm run dev (server starts on http://localhost:3000) • Check /health endpoint returns 200 OK • Run npm run test:dev to confirm database connection COMMON PITFALLS • Don't run prisma migrate dev on shared .env — migrate dev resets local data. Use db push for local work. • Redis connection failed? Ensure Docker container is running: docker ps • Port conflicts? Postgres defaults to 5432. Check lsof -i :5432 to find conflicts.
About this skill
name: onboarding-guide description: Use when Moves the entire local development setup and onboarding guide out of Notion and into a Claude skill so new team members can be onboarded by Claude directly.
Onboarding Guide
Previously hosted as a Notion page, the full guide for setting up and running every app and service needed for local development was moved directly into a Claude Code skill. Now when a new engineer, intern, or non-technical co-founder needs to get their environment running, Claude references this skill directly instead of the person hunting through a Notion doc — collapsing setup friction and keeping the guide as a living, referenceable source of truth.
What you get
- Full local dev environment setup guide as a skill, referenced automatically by Claude during onboarding, replaces static Notion documentation, single source of truth alongside code.
Customize your output
- Update the skill directly as your stack changes instead of maintaining a separate Notion doc that drifts out of sync.
Example output
New engineering intern asked Claude to set up their local environment — Claude walked through every service and dependency using the onboarding skill with zero founder involvement.
Best for
Founders and teams onboarding new engineers, interns, or non-technical co-founders who want setup guidance to live with the code, not in a separate doc.
SKILL.md preview
---
name: onboarding-guide
description: Use when a new engineer, intern, or non-technical co-founder needs to set up their local development environment and get every required app or service running.
version: 1.0.0
category: Development / Team Enablement
author: AgentVolt
license: proprietary
tags:
- development
- team-enablement
- standard
---
# Onboarding Guide
Serves as the living source of truth for local development setup, walking a new team member through every app and service needed to run the project locally.
## When to use
… (sign up to view the full skill)