speckit-git-validate

Validate Git feature branch names against specs directory prefixes.

2|Updated Feb 16, 2026
One-click install
npx skills add https://github.com/d0whc3r/statsig-browser-extension --skill speckit-git-validate-d0whc3r
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-git-validate
Source: https://github.com/d0whc3r/statsig-browser-extension/tree/main/.trae/skills/speckit-git-validate
Command: npx skills add https://github.com/d0whc3r/statsig-browser-extension --skill speckit-git-validate-d0whc3r

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents wasted time and broken workflows caused by feature branches that do not follow the expected naming convention.

Core Features & Use Cases

  • Branch Naming Validation: Checks the current Git branch against sequential (numeric prefix) and timestamp-based patterns.
  • Spec Directory Lookup: Verifies the corresponding spec directory exists under specs/ based on the extracted prefix.
  • Graceful Fallback: Skips cleanly when Git is unavailable and can optionally validate SPECIFY_FEATURE as a fallback.

Quick Start

Use the speckit-git-validate skill to validate your current branch name and confirm that its matching specs/ prefix directory exists.

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 Git feature branch naming conventions against spec directories?

To validate Git feature branch naming, extract the current branch name, match it against sequential numeric or timestamp-based regex patterns, and confirm the corresponding specs/ prefix directory exists. This prevents broken workflows caused by misnamed feature branches.

What is the best way to enforce CI guardrails for branch naming and spec directory correspondence?

Enforcing CI guardrails for branch naming involves checking Git repository availability, extracting the branch name, applying regex pattern matching for supported prefixes, and verifying the matching specs directory exists to ensure workflow consistency across feature development.

Does Git branch validation work when the repository is unavailable?

Git branch validation handles repository unavailability gracefully by skipping cleanly and optionally validating the SPECIFY_FEATURE environment variable as a fallback, ensuring workflow consistency is maintained even outside a Git context.

How do I check if my feature branch prefix matches a local specs directory?

Checking feature branch prefix correspondence involves extracting the branch name, applying regex patterns to identify the prefix, and verifying that a matching specs/<prefix>-* directory exists locally to maintain workflow consistency during development.

What regex patterns are supported for timestamp-based and sequential feature branch validation?

Feature branch validation supports two primary regex pattern formats: sequential numeric prefixes and timestamp-based prefixes. Both patterns are matched against the current branch name to extract the prefix used for spec directory lookup.

Why does feature branch validation fail when the specs directory is missing?

Feature branch validation fails when the specs directory is missing because the Skill enforces strict correspondence between the extracted branch prefix and the local specs/<prefix>-* directory, preventing wasted time on disconnected branches.