repo-onboarding
Repository onboarding and agent bootstrap. Use at the start of a new repo session or before any task to load AGENTS.md, architecture/skills indexes, and discover local Codex skills.
When & Why to Use This Skill
The repo-onboarding skill is designed to automate the initialization and context-loading process for AI agents within a software repository. It solves the problem of 'cold-start' inefficiency by systematically discovering local governance files, architecture indexes, and specialized Codex skills, ensuring the agent operates with full awareness of project-specific standards and available tools from the very first interaction.
Use Cases
- New Session Initialization: Automatically bootstrap an agent's understanding of a complex codebase by loading AGENTS.md and architecture references at the start of a task.
- Local Skill Discovery: Scan the repository's directory structure to identify and register custom-built skills (SKILL.md) that are unique to the specific project environment.
- Governance Enforcement: Ensure the agent adheres to 'Golden Paths' and project constraints by indexing documentation before any code modifications are performed.
- Architecture Alignment: Synchronize the agent's internal model with the latest architecture docs to prevent technical debt and ensure design consistency.
| name | repo-onboarding |
|---|---|
| description | Repository onboarding and agent bootstrap. Use at the start of a new repo session or before any task to load AGENTS.md, architecture/skills indexes, and discover local Codex skills. |
Repo Onboarding
Overview
Load repo governance and skills before acting.
Workflow
- Read
AGENTS.md. Follow any "Golden Path" or referenced indexes. - Load architecture references:
- If
AGENTS.mdpoints to.agent-docs/architecture.md, open it. - Otherwise open
architecture.mdand any index it references.
- Load skills references:
- Open
.agent-docs/SKILLS.mdandskills.mdif present. - Scan
skills/for*/SKILL.mdand list available Codex skills (name + path).
- Choose skills:
- If the task matches a skill description, load it and follow its workflow.
- Use
docs-auto-syncwhenever code changes are made.
- Summarize: confirm which docs/skills were loaded and any constraints found.
Resources
references/bootstrap-sources.md