speckit-git-initialize

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

Updated May 28, 2026
One-click install
npx skills add https://github.com/whw23/PingoGate --skill speckit-git-initialize-whw23
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: speckit-git-initialize
Source: https://github.com/whw23/PingoGate/tree/main/.claude/skills/speckit-git-initialize
Command: npx skills add https://github.com/whw23/PingoGate --skill speckit-git-initialize-whw23

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Setting up version control is a required first step for any new project, but manually running git init, staging files, and creating the first commit is repetitive and easy to forget. This Skill automates Git repository initialization within a spec-kit project structure, handling edge cases like missing Git installations or existing repositories. ## Core Features & Use Cases - Automated Repository Setup: Runs git init, git add, and an initial commit via Bash or PowerShell scripts with built-in checks. - Graceful Degradation: Skips initialization safely if Git is unavailable or a repository already exists, without breaking the project workflow. - Customizable Hooks: Supports project-specific extensions such as .gitignore templates, default branch naming, Git LFS, and commit signing. - Use Case: After scaffolding a new spec-kit project, invoke this Skill to immediately place the specs/ directory and template files 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 automatically?▼

Run the provided Bash or PowerShell script from the project root, which executes git init, git add, and git commit with a default message. If the scripts are missing, the fallback commands perform the same steps directly.

What happens if Git is not installed when initializing a repository?▼

The script detects the missing Git installation, warns the user, and skips initialization. The project continues to function, and specifications can still be created under the specs/ directory without version control.

Does git init fail if a repository already exists?▼

The script checks whether the current directory is already inside a Git repository and skips initialization if so. This prevents accidental re-initialization or nested repository issues.

Can I customize the initial Git setup with gitignore or Git LFS?▼

Yes, replace the default script to add custom .gitignore templates, default branch naming, Git LFS setup, hooks installation, commit signing, or Git Flow initialization.

Why does the initial commit fail after git init succeeds?▼

Failures typically occur when git add or git commit encounters errors such as missing user identity configuration. The Skill surfaces the error and stops rather than leaving a partially initialized repository.