skills.rest
MartinoPolo
MartinoPoloCOMMUNITY
Explore all skills by this author →
GitHub

mp-init-repo

Initialize a git repository with GitHub remotes and dev-branch governance.

1|Updated Feb 7, 2026
Search Tags:#git#github#claude code#project scaffolding#repository setup#branch protection
One-click install
npx skills add https://github.com/MartinoPolo/mpx-claude-code --skill mp-init-repo
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: mp-init-repo
Source: https://github.com/MartinoPolo/mpx-claude-code/tree/main/skills/mp-init-repo
Command: npx skills add https://github.com/MartinoPolo/mpx-claude-code --skill mp-init-repo

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Starting a new project often wastes time on repetitive setup steps like initializing Git, creating a remote, choosing a default branch strategy, and configuring basic governance like branch protection.

Core Features & Use Cases

  • Repo initialization and guardrails: Creates a new git repository, applies a comprehensive multi-language .gitignore, and establishes a predictable Claude Code project layout.
  • Project documentation scaffolding: Generates a versioned .mpx/ folder with CONTEXT.md (domain language, feature index, constraints) and DECISIONS.md (settled architecture/design decisions).
  • GitHub bootstrap with branching workflow: Pushes to a GitHub repository, renames the default branch to main when needed, creates a dev branch, and sets dev as the default branch; attempts branch protection on main and dev (with a graceful warning on Free-plan limitations).

Quick Start

Run mp-init-repo in an empty/new project directory to initialize git, create the GitHub repo, and set up the main/dev branch workflow.

Frequently Asked Questions about mp-init-repo

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

FAQPage Schema
How do I initialize a new GitHub repository with a dev branch workflow?▼

To initialize a new GitHub repository with a dev branch workflow, this Skill creates a git repository, pushes it to GitHub, renames the default branch to main, creates a dev branch, and sets dev as the default branch.

What is the best way to scaffold project documentation for a new Claude Code project?▼

The best way to scaffold documentation for a new Claude Code project is to generate a versioned .mpx/ folder containing CONTEXT.md for domain language and feature indexing, and DECISIONS.md for settled architecture decisions.

Does this repo setup tool configure branch protection on GitHub Free plans?▼

This repo setup tool attempts to configure branch protection on main and dev branches, but it handles GitHub Free-plan branch-protection failures gracefully by issuing a warning rather than blocking the setup process.

How do I bootstrap a git repository with a comprehensive multi-language .gitignore?▼

To bootstrap a git repository with a multi-language .gitignore, this Skill initializes the repository and automatically applies a comprehensive .gitignore template alongside project documentation scaffolding during setup.

Related Skills

Explore More Software Engineering Skills→
Overlord-ZOverlord-Z

smart-init

Initialize ClaudeShack by analyzing codebases and seeding Oracle knowledge.

Community
Advanced
glowingkittyglowingkitty
43

openmates:pullrequest

Create GitHub pull requests from dev to main with categorized commit descriptions.

Community
Intermediate
pecorapromotionsllc-cellpecorapromotionsllc-cell

documentation-and-adrs

Document architectural decisions and project context in ADR templates.

Community
Advanced
tomholfordtomholford
6

draft-pr

Automate staging, committing, pushing, and opening draft pull requests.

Community
Intermediate