speckit-git-validate

Validate Git branch names against feature patterns and spec directories.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Validate that the current Git branch adheres to feature-branch naming conventions.

Core Features & Use Cases

  • Checks branch name against sequential and timestamp patterns.
  • Verifies existence of corresponding spec directories under specs/ for matching prefixes.
  • Use case: When starting work on a new feature, ensure naming consistency to map to specs/.

Quick Start

Run the speckit-git-validate command to validate your current branch name against the supported feature patterns.

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 my Git branch name against feature-branch naming conventions?

To validate a Git branch name against feature-branch naming conventions, run the validation command to check the current branch against supported sequential and timestamp patterns. It also verifies a corresponding spec directory exists under specs/ for the detected prefix.

What happens to branch name validation if Git is unavailable or not a repository?

If Git is unavailable or the current directory is not a repository, branch name validation applies graceful degradation by falling back to the SPECIFY_FEATURE variable or skipping the validation entirely to avoid blocking your workflow.

Does feature-branch naming validation check for corresponding spec directories?

Yes, feature-branch naming validation checks for corresponding spec directories. After identifying a matching branch name prefix, it verifies that the expected spec directory exists under the specs/ folder to maintain project consistency.

What Git branch naming patterns are supported for feature-branch validation?

Feature-branch validation supports both sequential and timestamp naming patterns. It identifies whether the current Git branch name matches these supported feature naming conventions before verifying the associated spec directory structure.

When do I need to validate feature-branch naming conventions in my workflow?

You need to validate feature-branch naming conventions when starting work on a new feature. This ensures naming consistency across your team and correctly maps the active branch to its corresponding specification directory under specs/.