speckit-git-initialize

Initialize Git repositories with an initial commit in existing project directories.

60|12|Updated Aug 1, 2013
One-click install
npx skills add https://github.com/vtex/front.phone --skill speckit-git-initialize-vtex
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-git-initialize
Source: https://github.com/vtex/front.phone/tree/main/.agents/skills/speckit-git-initialize
Command: npx skills add https://github.com/vtex/front.phone --skill speckit-git-initialize-vtex

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Setting up a Git repository often takes multiple manual steps, and doing it inconsistently can lead to errors, missing files, or an incomplete initial history.

Core Features & Use Cases

  • Auto-initialize when needed: Creates a Git repository in the current project directory only if one does not already exist.
  • Deterministic initial commit flow: Adds all files and creates an initial commit with a template message, using the extension scripts when available.
  • Graceful fallback and safety checks: Skips initialization when Git is unavailable or a repository already exists, and stops with an error if initialization commands fail.

Quick Start

Tell the AI to initialize Git in the current project directory using the speckit-git-initialize skill.

Frequently Asked Questions about speckit-git-initialize

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

FAQPage Schema
How do I create a safe initial commit when initializing a Git repository in an existing project directory?

To create a safe initial commit during Git repository initialization, the skill checks for an existing repository and skips if present, then runs git init, adds all files, and commits with a template message. It stops with an error if commands fail.

What happens if Git is not installed or a repository already exists in the directory?

If Git is missing or a repository already exists in the directory, the initialization process gracefully skips execution. These guardrails prevent errors and avoid overwriting existing repository history during project bootstrapping.

Can I use this Git initialization process on both Bash and PowerShell environments?

Yes, the Git initialization process supports cross-platform environments including both Bash and PowerShell. It automatically detects and executes existing extension scripts when available, ensuring consistent bootstrapping across different operating systems.

How do I bootstrap a new codebase with the spec-kit directory structure and initialize version control?

To bootstrap a new codebase with the spec-kit directory structure, run the initialization process in your project directory. It creates an initial commit using extension scripts if present, or falls back to standard git init, add, and commit commands.

Does the initialization process run custom extension scripts or use standard Git commands?

The initialization process executes existing extension scripts when available for custom bootstrapping flows. If no extension scripts are found, it falls back to standard git init, add, and commit commands to create the initial repository state.