init-repo

Bootstrap repository docs and policies via Python scripts and YAML configurations.

9|3|Updated Apr 9, 2026
One-click install
npx skills add https://github.com/corca-ai/charness --skill init-repo-corca-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: init-repo
Source: https://github.com/corca-ai/charness/tree/main/plugins/charness/skills/init-repo
Command: npx skills add https://github.com/corca-ai/charness --skill init-repo-corca-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Bootstraps and standardizes the initial operating surface of a repository, ensuring durable governance surfaces and sane defaults across docs and policy surfaces.

Core Features & Use Cases

  • Detect greenfield vs partially-initialized repos and tailor the workflow accordingly.
  • Scaffold or realign essential surfaces like AGENTS.md, CLAUDE.md symlink, README, ROADMAP, and operator-acceptance docs.
  • Normalize or seed surfaces into a coherent repo contract, with optional retro-memory and policy guidance.

Quick Start

Run the init-repo skill to bootstrap the repository surfaces.

Frequently Asked Questions about init-repo

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

FAQPage Schema
How do I bootstrap a new repository with AGENTS.md and policy documentation?

To bootstrap a repository with AGENTS.md and policy documentation, run the init-repo skill to scaffold essential surfaces like CLAUDE.md symlinks, ROADMAP, and operator-acceptance docs. It detects greenfield or partially-initialized repos and tailors the workflow accordingly.

What is repository surface normalization and when do I need it?

Repository surface normalization standardizes a repo's durable operating surface by establishing core docs and policies. You need it when aligning AGENTS.md, README, and ROADMAP files into a coherent repo contract with consistent governance defaults.

Can I use init-repo on a partially-initialized repository that already has some documentation?

Yes, you can use init-repo on a partially-initialized repository. It detects existing surfaces and realigns them into a coherent repo contract, applying policy-driven adapter flow and bounded-review routing to normalize what is already present.

What's the best way to establish documentation policy across multiple repository surfaces?

The best way to establish documentation policy across repository surfaces is using a policy-driven adapter flow with YAML configurations and Python scripts. This approach seeds and normalizes AGENTS.md, CLAUDE.md, and ROADMAP files into a unified governance contract.

Does bootstrapping repository surfaces require any external dependencies?

Bootstrapping repository surfaces does not require external dependencies. The skill operates self-contained using Python scripts and YAML configurations to implement surface resolution, policy-driven adapter flow, and bounded-review routing for greenfield or existing repos.

How do I scaffold a CLAUDE.md symlink and ROADMAP for a greenfield project?

To scaffold a CLAUDE.md symlink and ROADMAP for a greenfield project, run the init-repo skill which establishes these surfaces through automated detection and policy alignment. It guides ideation and scaffolding with optional retro-memory and policy guidance.