skills.rest
spinlockdevelopment
spinlockdevelopmentOFFICIAL
Explore all skills by this author →
GitHub

init-project

Ensures git main branch, updates CLAUDE.md and README.md, stamps PR workflow rules, junctions dependency skills, and reports missing plugins.

1|Updated Apr 14, 2026
Search Tags:#automation#git#claude#readme#idempotent#claude-md#init-project
One-click install
npx skills add https://github.com/spinlockdevelopment/dev-setup --skill init-project-spinlockdevelopment
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: init-project
Source: https://github.com/spinlockdevelopment/dev-setup/tree/main/plugins/spindev-core/skills/init-project
Command: npx skills add https://github.com/spinlockdevelopment/dev-setup --skill init-project-spinlockdevelopment

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires git, gh, and includes scripts (resource) components.

What problem does it solve?

This skill automates bringing a repository to a Claude-ready baseline so users don't have to repeatedly perform brittle, manual setup steps across projects.

Core Features & Use Cases

  • Ensures a git repository exists with main as the default branch and detects bringup versus protected project mode.
  • Creates or updates CLAUDE.md and README.md idempotently, manages the Project Mode breadcrumb, and stamps a canonical PR-workflow rules block.
  • Junctions dev-setup-owned dependency skills into the user's skills tree and reports missing plugin-sourced skills with exact install hints; useful when onboarding fresh clones or preparing a project for safe PRs.

Quick Start

Run the init-project skill to prepare this repository for Claude by ensuring main branch, creating or updating CLAUDE.md and README.md, stamping PR rules, and reporting dependency skills.

Frequently Asked Questions about init-project

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

FAQPage Schema
How do I prepare a git repository for Claude automatically?▼

To prepare a git repository for Claude, you can automate the baseline setup by ensuring a main branch exists, generating CLAUDE.md and README.md, and stamping PR workflow rules. This process detects whether the project is in bringup or protected mode to apply safe, idempotent file edits.

What does idempotent repository initialization do for my project files?▼

Idempotent repository initialization safely creates or updates CLAUDE.md and README.md without overwriting existing customizations. It manages the Project Mode breadcrumb and stamps a canonical PR-workflow rules block, ensuring repeated maintenance runs yield consistent baseline files.

Do I need git and gh installed to set up my Claude project baseline?▼

Yes, you need both git and gh installed to set up your Claude project baseline. The initialization process relies on git for state detection and branch management, and uses gh to handle repository interactions and report missing plugin skills with exact install hints.

Can I run project initialization on an existing protected git branch?▼

Yes, you can run project initialization on an existing protected git branch. The skill detects bringup versus protected project mode and prompts before performing any destructive git operations, ensuring safe repeated maintenance on mature repositories.

Related Skills

Explore More Software Engineering Skills→
faccomichelefaccomichele

github-read-access

Inspect GitHub repository data, issues, pull requests, releases, and CI runs via gh CLI.

Community
Intermediate
tneztnez
2

pr

Creates a pull request from the current branch to main using GitHub CLI.

Community
Intermediate
furedeafuredea
1

nix-dev-init

Automates repository setup, Nix flake configuration, and direnv for project environments.

Community
Intermediate
oduffy-delphioduffy-delphi
5

finishing-a-development-branch

Present merge, PR, keep, or discard options for a completed Git branch.

Community
Advanced