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.

⭐5stars🔀1forks📁View on GitHub🕐Updated Jan 11, 2026

When & Why to Use This Skill

The Repo Onboarding skill is an essential bootstrap utility designed to synchronize AI agents with a new codebase. It automates the initialization process by indexing repository governance (AGENTS.md), architectural frameworks, and local Codex skills. By establishing a comprehensive context of the project's 'Golden Path' and available tools before any tasks are executed, it ensures that the agent operates with high precision and adheres to project-specific standards.

Use Cases

  • New Project Session: Use at the start of a session to quickly familiarize the AI agent with a complex or unfamiliar repository structure.
  • Automated Skill Discovery: Automatically scan and list project-specific Codex skills located in the skills/ directory to extend agent capabilities.
  • Architecture Alignment: Ensure the agent reads and follows architecture.md and related documentation to maintain design consistency during code generation.
  • Governance Compliance: Load AGENTS.md to enforce repository-specific rules, constraints, and workflows before the agent performs any modifications.
  • Documentation Sync: Integrate with docs-auto-sync to ensure that any code changes made by the agent are reflected in the project documentation automatically.
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