speckit-git-initialize

Initialize a Git repository and create an initial commit in the current project.

Updated Apr 3, 2026
One-click install
npx skills add https://github.com/nq-rdl/agent-skills --skill speckit-git-initialize-nq-rdl
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-git-initialize
Source: https://github.com/nq-rdl/agent-skills/tree/main/.claude/skills/speckit-git-initialize
Command: npx skills add https://github.com/nq-rdl/agent-skills --skill speckit-git-initialize-nq-rdl

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Initialize a Git repository and create an initial commit for new projects, ensuring version control is established quickly and consistently.

Core Features & Use Cases

  • Initialize a Git repository in the current project directory if one does not exist
  • Run the appropriate initialization script for Bash or PowerShell, with a safe fallback to standard git commands
  • Validate environment and avoid reinitializing an existing repository
  • Provide customization options for default branch, hooks, and more

Quick Start

Run the appropriate script from the project root to initialize a new Git repository.

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 and create the initial commit?

To initialize a Git repository, the Skill runs git init, git add ., and git commit with a consistent default message. It first checks whether Git is available and avoids reinitializing existing repositories to ensure safe project version control setup.

Does this Git initialization work with both Bash and PowerShell environments?

Yes, Git initialization works with both Bash and PowerShell environments. The Skill runs the appropriate initialization script for your shell, with a safe fallback to standard git commands when shell-specific scripts are unavailable.

Will running git init on an existing repository overwrite my project history?

Running git init on an existing repository will not overwrite your project history. The Skill validates the environment and explicitly avoids reinitializing existing repositories, preventing accidental data loss or duplicate version control configurations.

Can I customize the default branch name when setting up a new repository?

Yes, you can customize the default branch name when setting up a new repository. The Skill provides customization options for the default branch, hooks, and other settings, allowing you to establish version control with your preferred configuration.

What happens if Git is not installed on my system when I try to initialize a project?

If Git is not installed on your system, the initialization process will halt. The Skill explicitly checks for Git availability before attempting any operations, ensuring the environment can support version control commands before proceeding.

Why does my initial commit fail when I try to set up version control automatically?

Your initial commit might fail if Git is unavailable or the directory is already an existing repository. This Skill prevents such failures by checking prerequisites, validating the environment, and applying standard git commands with a consistent commit message.