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.

⭐0stars🔀0forks📁View on GitHub🕐Updated Dec 23, 2025

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.
namerepo-onboarding
descriptionRepository 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

  1. Read AGENTS.md. Follow any "Golden Path" or referenced indexes.
  2. Load architecture references:
  • If AGENTS.md points to .agent-docs/architecture.md, open it.
  • Otherwise open architecture.md and any index it references.
  1. Load skills references:
  • Open .agent-docs/SKILLS.md and skills.md if present.
  • Scan skills/ for */SKILL.md and list available Codex skills (name + path).
  1. Choose skills:
  • If the task matches a skill description, load it and follow its workflow.
  • Use docs-auto-sync whenever code changes are made.
  1. Summarize: confirm which docs/skills were loaded and any constraints found.

Resources

  • references/bootstrap-sources.md