speckit-git-validate

Validates Git branch names against spec-kit feature branch naming conventions.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams using spec-kit workflows need feature branches to follow strict naming conventions so that specs, branches, and directories stay linked. Manually checking branch names is error-prone, and working on a misnamed branch can break downstream spec tooling. ## Core Features & Use Cases - Branch Name Validation: Checks the current Git branch against sequential patterns (e.g., 001-feature-name) and timestamp patterns (e.g., 20260319-143022-feature-name). - Spec Directory Detection: Verifies that a matching spec directory exists under specs/ for the branch prefix. - Graceful Degradation: Falls back to the SPECIFY_FEATURE environment variable when Git is unavailable, and skips validation with a warning instead of failing. - Use Case: Before running spec-kit commands like plan or implement, validate that you are on a properly named feature branch so generated artifacts land in the correct spec directory. ## Quick Start Ask the assistant to validate that the current Git branch follows the spec-kit feature branch naming convention.

Frequently Asked Questions about speckit-git-validate

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

FAQPage Schema
How do I validate a Git feature branch name in a spec-kit project?▼

Run the validation to compare the current branch from git rev-parse --abbrev-ref HEAD against the accepted patterns. Sequential branches must start with three or more digits and a hyphen, while timestamp branches use YYYYMMDD-HHMMSS prefixes.

What branch naming conventions does spec-kit use?▼

Spec-kit accepts two patterns: sequential names like 001-feature-name or 1000-big-feature matching ^[0-9]{3}-, and timestamp names like 20260319-143022-feature-name matching ^[0-9]{8}-[0-9]{6}-. Other branch names are reported as non-feature branches.

Does branch validation work without Git installed?▼

Yes, it degrades gracefully. When Git is missing or the directory is not a repository, it checks the SPECIFY_FEATURE environment variable and validates that value instead. If neither is available, it skips validation with a warning.

Why does validation warn about a missing spec directory?▼

The warning appears when the branch name is valid but no matching directory exists under specs/ for the branch prefix. This usually means the spec was not created yet or the branch prefix does not match the spec folder name.

When should I run feature branch validation?▼

Run it before executing spec-kit workflow commands such as plan, tasks, or implement. Validating early ensures generated artifacts are written to the correct spec directory tied to your feature branch.