team-onboarding

/team-onboarding — Ramp-Up Guide Generator

Port of Claude Code's /team-onboarding.

Steps

1. Gather context

   • Read AGENTS.md if present (run the init skill first if it doesn't exist and the user confirms they want it generated).
   • List installed project-level skills (.agent/skills/*/SKILL.md) and summarize what each one does in one line, pulled from its description.
   • Pull the last ~20 commits (git log --oneline -20) to identify recent areas of active work.
   • Note any CI config, environment setup scripts, or .env.example files.

2. Produce ONBOARDING.md with:

# Onboarding: <project name>

## What this project does
<short description>

## Getting set up
<install/env steps, pulled from real scripts/config, not invented>

## Codebase map
<key directories and their purpose>

## Conventions
<from AGENTS.md>

## Useful agent skills available
<one line per skill>

## Recent activity
<2-3 sentence summary of what's been actively worked on lately, from git log>

## Where to start
<a concrete first task suggestion, e.g. "run the test suite", "read X module">

1. Keep it scannable — a new teammate should be productive after a 10-minute read, not handed a full architecture document.

Notes

Base everything on what's actually in the repo. If setup steps aren't documented anywhere, say "setup steps not found — ask a teammate" rather than guessing.