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.