speckit-git-initialize

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents new projects from being blocked by missing version control by automatically creating a Git repository and producing an initial commit when one does not already exist.

Core Features & Use Cases

  • Initialize Git safely: Detects whether a Git repo already exists and skips initialization when appropriate.
  • Create an initial commit: Runs git init, git add ., and git commit with a template-based message for consistent bootstrapping.
  • Graceful degradation: Warns and continues if Git is not installed, avoiding broken workflows.
  • Use Case: Use it when you generate a new Specify/spec-kit-based project and want it immediately ready for tracking changes in CI/CD or collaboration.

Quick Start

Ask the agent to initialize Git for the current Specify project workspace.

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 for a spec-kit project workspace?

To initialize a Git repository for a spec-kit project, the skill runs git init, git add, and git commit using a template-based message. It requires a .specify/ directory and automatically selects bash or PowerShell scripts if available.

What happens if I run Git initialization inside an existing repository?

When Git initialization is attempted inside an existing repository, the process applies safe skip behavior to avoid overwriting current version control artifacts. It detects the active repository and safely skips the initialization step without breaking your workflow.

Can I bootstrap version control in CI pipelines for Specify template workspaces?

Yes, you can bootstrap version control in CI pipelines for Specify template workspaces. The skill safely creates an initial commit during project scaffolding or CI bootstrap steps, ensuring version control artifacts are present for automated workflows.

Does Git initialization fail gracefully if Git is not installed?

Git initialization fails gracefully if Git is not installed on the system. The skill warns the user about the missing dependency and continues execution, preventing broken workflows during project scaffolding or local developer setup.

What is the best way to create an initial commit safely during project scaffolding?

The best way to create an initial commit during project scaffolding is using a safe initialization script that checks for existing repositories and Git availability. This approach runs git init, git add, and git commit with a template message to ensure consistent bootstrapping.