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
/plugin marketplace add ai-driven-dev/framework
/plugin install aidd-vcs@aidd-frameworkWhat 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-frameworkThis 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-code3Manually: put the files in place
~/.claude/skills/00-repo-init/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/00-repo-init/
1Skills CLI (Vercel)
npx skills add ai-driven-dev/framework --skill 00-repo-init -a codex2Manually: put the files in place
.agents/skills/00-repo-init/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add ai-driven-dev/framework --skill 00-repo-init -a cursor2Manually: put the files in place
.cursor/skills/00-repo-init/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install ai-driven-dev/framework plugins/aidd-vcs/skills/00-repo-init2Manually: put the files in place
.github/skills/00-repo-init/SKILL.md1Skills CLI (Vercel)
npx skills add ai-driven-dev/framework --skill 00-repo-init -a gemini-cli2Platform CLI
gemini skills install https://github.com/ai-driven-dev/framework --path plugins/aidd-vcs/skills/00-repo-initManually: put the files in place
.devin/skills/00-repo-init/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add ai-driven-dev/framework --skill 00-repo-init -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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