speckit-git-validate

Validate Git branch names against sequential or timestamped patterns and matching spec directories.

Updated Apr 25, 2026
One-click install
npx skills add https://github.com/sdk451/claude-gdrive --skill speckit-git-validate-sdk451
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: speckit-git-validate
Source: https://github.com/sdk451/claude-gdrive/tree/main/.cursor/skills/speckit-git-validate
Command: npx skills add https://github.com/sdk451/claude-gdrive --skill speckit-git-validate-sdk451

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Validates that the current Git branch name conforms to predefined feature-naming patterns, helping teams avoid misnamed branches and related workflow issues.

Core Features & Use Cases

  • Validates branch-name against sequential patterns like 001-feature-name and timestamp-based patterns like 20260319-143022-feature-name.
  • Checks for a corresponding spec directory under specs/ for the detected prefix to ensure alignment with the spec workflow.
  • Works in environments where Git is available and provides graceful fallback when Git is not present or not a repository.

Quick Start

Run the speckit-git-validate tool in your repository to confirm the current branch matches the accepted patterns and to verify the existence of a matching specs directory.

Frequently Asked Questions about speckit-git-validate

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

FAQPage Schema
How do I enforce feature branch naming conventions in Git?▼

To enforce feature branch naming conventions, validate current Git branches against sequential patterns like 001-feature-name or timestamped patterns like 20260319-143022-feature-name. This confirms branches match predefined specs and avoids misnamed branch workflow issues.

What Git branch naming patterns are valid for spec workflows?▼

Valid Git branch naming patterns for spec workflows include sequential names like 001-feature-name and timestamped names like 20260319-143022-feature-name. Matching prefixes must have corresponding spec directories under specs/ to ensure alignment.

Do I need Git installed to validate branch names against specs directories?▼

You do not need Git installed to validate branch names. If Git is unavailable or not a repository, validation falls back to the SPECIFY_FEATURE environment variable when provided, otherwise skipping with a warning.

How do I check if a Git branch has a matching specs directory?▼

To check if a Git branch has a matching specs directory, validate the branch name against allowed patterns and verify a corresponding spec directory exists under specs/ with a matching prefix like 001 or a timestamp.

What happens when Git branch validation fails in non-repository environments?▼

When Git branch validation fails in non-repository environments, the tool skips validation with a warning unless the SPECIFY_FEATURE environment variable is provided, in which case it uses that value for fallback validation.