Dev Onboarding Builder

What it does

The Dev Onboarding Builder skill automates the creation of developer onboarding documentation and workflows. It generates a structured ONBOARDING.md file, complete with checklists for access, installation instructions, time estimates, troubleshooting tips, and introductions to team members and codebase areas. This helps streamline the integration process for new developers and improves their initial productivity.

When to use it

• When you need to onboard new software engineers quickly and consistently.
• To reduce the burden on existing team members who are currently responsible for onboarding.
• For projects requiring specific tools like Node.js, pnpm, Docker, PostgreSQL, or VS Code.
• When standardizing the developer setup process across a team or organization is desired.
• To provide new hires with clear expectations and proactive solutions to common issues they might encounter.

Key capabilities

• Generates an ONBOARDING.md document following a predefined template.
• Includes access checklists (e.g., GitHub, Slack, cloud consoles).
• Provides step-by-step instructions for environment configuration.
• Suggests appropriate starter assignments and estimates time required.
• Documents common issues and troubleshooting steps.
• Introduces new hires to team members and provides a codebase tour.

Example prompts

• "Generate an onboarding guide for a new backend engineer joining the 'Project Phoenix' team."
• "Create an ONBOARDING.md file including setup instructions for Node.js, pnpm, and Docker."
• "Build an onboarding workflow that includes access to GitHub, Slack, and AWS console."

Tips & gotchas

• The generated ONBOARDING.md document relies on a predefined template; customization may require manual editing.
• Ensure new hires have the necessary prerequisites (e.g., Git configured with work email) before starting the onboarding process.
• Specific tool versions and credentials mentioned in the documentation might need to be updated regularly.