speckit-git-initialize

Initialize a Git repository with an initial commit in spec-kit projects.

4|Updated Oct 24, 2025
One-click install
npx skills add https://github.com/sethdavis512/iridium --skill speckit-git-initialize-sethdavis512
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-git-initialize
Source: https://github.com/sethdavis512/iridium/tree/main/.agents/skills/speckit-git-initialize
Command: npx skills add https://github.com/sethdavis512/iridium --skill speckit-git-initialize-sethdavis512

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Setting up version control is a repetitive first step in every new project, and forgetting it early leads to lost work and untracked changes. This Skill automates Git repository initialization with an initial commit so your spec-kit project is version-controlled from the start. ## Core Features & Use Cases - Automated Git Initialization: Runs git init, git add ., and creates an initial commit in one step via Bash or PowerShell scripts. - Idempotent and Safe: Skips initialization if Git is unavailable or the directory is already inside a Git repository. - Graceful Degradation: Warns and continues without Git rather than failing, so spec creation under specs/ still works. - Use Case: After scaffolding a new spec-kit project, invoke this Skill to immediately place the .specify/ structure and specs under version control with a clean initial commit. ## Quick Start Initialize a Git repository with an initial commit in my current spec-kit project directory.

Frequently Asked Questions about speckit-git-initialize

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

FAQPage Schema
How do I initialize a Git repository with an initial commit?

Run the initialization script from the project root, which executes git init, git add ., and git commit with a default message. Bash and PowerShell variants are provided, with direct git commands as a fallback if the scripts are missing.

What happens if I run git init inside an existing repository?

The script checks whether the directory is already inside a Git repository and skips initialization entirely. This prevents nested repositories or accidental re-initialization of existing version control.

Does this work if Git is not installed on my machine?

No, Git must be installed for initialization to succeed. If Git is unavailable, the script warns the user and skips the step, allowing spec creation under the specs/ directory to continue without version control.

Can I customize the initial commit message or add a .gitignore?

Yes, the script can be replaced or extended with project-specific steps such as custom .gitignore templates, default branch naming, Git LFS setup, hooks installation, and commit signing configuration.

Why does git initialization fail after git init succeeds?

Failures during git add or git commit typically stem from permission issues, missing user identity configuration, or empty directories. The command stops and surfaces the error rather than continuing with a partially initialized repository.