repo-bootstrap

Installs agents, skills, hooks, and CLAUDE.md templates into a new repository.

1|Updated Apr 16, 2026
One-click install
npx skills add https://github.com/OgenticAI/ogentic-shield --skill repo-bootstrap-ogenticai
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: repo-bootstrap
Source: https://github.com/OgenticAI/ogentic-shield/tree/main/.claude/skills/repo-bootstrap
Command: npx skills add https://github.com/OgenticAI/ogentic-shield --skill repo-bootstrap-ogenticai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Setting up a new repository with a consistent AI agent factory—agents, skills, hooks, and governance files—requires copying many files, detecting the tech stack, and configuring git hooks manually, which is error-prone and inconsistent across repos. ## Core Features & Use Cases - Stack Detection and Kit Installation: Detects Node/TS, Python, Prisma, and Alembic setups, then copies agents, skills, hooks, and a registry template into the repo. - Tailored CLAUDE.md Generation: Pre-fills a CLAUDE.md template with detected stack commands while leaving architecture rules for the human. - New Agent Scaffolding and Charter: For new agents, applies a governed scaffold wired to @ogenticai/agent-core and walks the operator through an eight-question charter recorded as a decision document. - Use Case: An engineer adopting the factory in a fresh repo runs this skill to get agents, pre-commit hooks that block .env commits, and a smoke-tested setup in one pass. ## Quick Start Ask the assistant to install the factory in this repository and confirm the detected stack profile when prompted.

Frequently Asked Questions about repo-bootstrap

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I install an agent factory into a new repository?▼

Run the repo-bootstrap skill, which detects your stack from files like package.json or pyproject.toml, confirms the profile with you, then copies agents, skills, hooks, and a CLAUDE.md template into the repo root.

What does the repo bootstrap pre-flight check verify?▼

The setup-check step verifies gh CLI authentication as the org-admin account, an OgenticAI git author email, the SSH key for plugin pushes, and a sensible current branch. It halts with the exact fix if anything is misconfigured.

Does repo-bootstrap work on repos that already have a .claude folder?▼

It does not overwrite an existing .claude/ folder. If one exists, the skill asks before merging, so existing agent or skill configurations are preserved until the operator approves changes.

When should the agent scaffold be applied during bootstrap?▼

The agent scaffold applies only when the target repo is a brand-new agent, not an existing app adopting the factory. It copies governed starter code pre-wired to @ogenticai/agent-core so Shield and Audit enforcement exists from the first commit.

Why does the bootstrap smoke test commit a fake .env file?▼

The smoke test attempts to commit a fake .env file to confirm the pre-commit hook blocks it, proving secret protection works before real development begins. The test commit is reverted immediately afterward.