Skip to main content
skill CX Codex

00-repo-init — Claude Code skill: what it does, how to install

00-repo-init prepares a fresh Git repository with a default branch, CONTRIBUTING.md, and a bootstrap commit, then pushes it to a remote host on request.

MIT ★ 571 updated 2026-10-29

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add ai-driven-dev/framework
/plugin install aidd-vcs@aidd-framework
Open on GitHub

What 00-repo-init does

This skill handles project initialization through two discrete actions: init and publish. It resolves VCS preferences, runs git init, picks the default branch (main fallback), writes a CONTRIBUTING.md template, and creates a blank commit with --allow-empty so HEAD exists immediately. The local setup is idempotent. If the target directory already contains a Git work tree, the action reports and exits safely.

The publish step provisions the repository on your hosting provider using whichever CLI, MCP, or API tool is available in your shell. It asks for explicit confirmation before making remote changes unless non_interactive is passed. Without git on your PATH and an active login in your provider tooling, publishing fails.

What it helps with

  • Initialize a local Git work tree for a new project directory
  • Generate a root CONTRIBUTING.md from a bundled template
  • Create a bootstrap commit with --allow-empty to establish HEAD
  • Provision and push to a remote repository via provider tooling

Example prompts for the agent

  • Initialize a new git repository in the current folder
  • Set up a local repo with CONTRIBUTING.md and a bootstrap commit
  • Publish this project to a remote git host and return the URL

How to install 00-repo-init

1Plugin marketplace

/plugin marketplace add ai-driven-dev/framework
/plugin install aidd-vcs@aidd-framework

This installs the whole aidd-vcs plugin with all its skills

2Skills CLI (Vercel)

npx skills add ai-driven-dev/framework --skill 00-repo-init -a claude-code

3Manually: put the files in place

~/.claude/skills/00-repo-init/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/00-repo-init/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about 00-repo-init

How to install 00-repo-init in Claude Code?

Run /plugin marketplace add ai-driven-dev/framework, then run /plugin install aidd-vcs@aidd-framework.

What does 00-repo-init do?

It configures a local Git repository with CONTRIBUTING.md, creates an empty commit to establish HEAD, and optionally pushes the project to a remote host.

What are the prerequisites for 00-repo-init?

You need git in your PATH. For remote publishing, tooling for your VCS provider (CLI, MCP, or API) must be installed and authenticated.

Source text

SKILL.md · MIT
---
name: 00-repo-init
description: Initialize a project repository with git init, a default branch, a bootstrap commit, CONTRIBUTING.md, and optionally the remote. Use when the user wants to init or set up a new repo, or publish to a remote. Not for committing, opening a PR, or tagging.
argument-hint: directory | remote
---

# Repo Init

> Status: experimental.

Initializes a project's repository locally and, on request, on the remote host, then returns the remote URL.

## Actions

| #   | Action    | Role                                                                                              | Input                           |
| --- | --------- | ------------------------------------------------------------------------------------------------- | ------------------------------- |
| 01  | `init`    | Resolve VCS config, `git init`, set the default branch, write `CONTRIBUTING.md`, bootstrap commit | cwd, default_branch, remote_url |
| 02  | `publish` | Create the remote repo on the resolved host and push, return its URL                              | cwd, non_interactive            |

Run `01 → 02`. `init` alone for local-only; `publish` after it to create the remote.
Before running an action, read its file in `actions/`, not only the table or assets.

## Transversal rules

- The local step is idempotent. If the target is already a git work tree, `init` does nothing and reports.
- `init` makes one bootstrap commit (`--allow-empty`) so `HEAD` exists and is pushable. The project's real first commit stays the commit skill's job.
- `publish` is outward-facing. It confirms before creating the remote unless `non_interactive` is set.
- The provider is open. Resolve the host and how to reach it (CLI, MCP, or API) from the VCS memory when present, else from the VCS tooling available in the environment. Never restrict to a fixed list or a fixed mechanism. `main` is the default-branch fallback.

## Prerequisites

- `git` on the PATH. For `publish`, the resolved host's tooling (CLI, MCP, or API) available and authenticated.

## Assets

- `assets/CONTRIBUTING.md`: the project-root `CONTRIBUTING.md` template.

© AI-Driven Dev · MIT · ai-driven-dev/framework

Similar skills

All skills for Git and GitHub →

From the same set80

The whole set →
01-usage 01-usage is a Claude Code skill that reports token use by period or task, split by day, model, agent or ticket, from a local aidd telemetry report. CX Codex +1 ★ 571repo stars 01-sdlc 01-sdlc orchestrates changes from contract framing to a draft pull request across Frame, Deliver, and Check zones. Use it for end-to-end tasks instead of single-step code edits. CX Codex +1 ★ 571repo stars 12-cook 12-cook is a Claude Code skill for finding and maintaining project recipes, researching techniques, and applying existing guides. It can also check recipe steps and investigate improvements. CX Codex +1 ★ 571repo stars 03-assert 03-assert runs a project's assertions and fixes code until they pass, with optional checks on architecture and a running UI. Useful as the last gate before you push. CX Codex +1 ★ 571repo stars 09-for-sure The 09-for-sure skill runs an agent through repeated attempts until a runnable success check passes. Use it for work with a result that can be verified, such as a command. CX Codex +1 ★ 571repo stars 07-refactor 07-refactor rewrites code along one of four axes: performance, security, cleanup, architecture. It scans on its own or takes a finished audit report as the to-do list. CX Codex +1 ★ 571repo stars 00-init 00-init controls AIDD telemetry in projects: turns resource tracking on or off with consent, configures identity, or purges recorded metrics. CX Codex +1 ★ 571repo stars 03-shadow-areas 03-shadow-areas — a skill that scans written artifacts (ideas, user stories, PRDs, specs) and produces a structured report of blind spots—what the author has not addressed. Runs on Claude Code, Cursor, Codex, GitHub Copilot, and OpenCode. CX Codex +1 ★ 571repo stars

Project sponsors

Companies that keep this analytics open