speckit-git-validate

Validate Git branch names against feature naming conventions and matching spec directories.

Updated Apr 12, 2026
One-click install
npx skills add https://github.com/ZainEldeen-Ashraf-Ibrahim-Ibrahim-Samak/SCCT --skill speckit-git-validate
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-git-validate
Source: https://github.com/ZainEldeen-Ashraf-Ibrahim-Ibrahim-Samak/SCCT/tree/main/.agent/skills/speckit-git-validate
Command: npx skills add https://github.com/ZainEldeen-Ashraf-Ibrahim-Ibrahim-Samak/SCCT --skill speckit-git-validate

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill checks that the active Git branch follows prescribed feature branch naming conventions and ensures there is a corresponding spec directory, reducing naming mismatches and missing specification files during development.

Core Features & Use Cases

  • Validates branch names against sequential (e.g., 001-feature) and timestamp (e.g., 20260319-143022-feature) patterns to enforce team conventions.
  • Verifies the presence of a matching specs/<prefix>-* directory for the branch prefix and reports success or warnings.
  • Gracefully degrades by checking the SPECIFY_FEATURE environment variable when Git is unavailable and provides clear user-facing messages for each outcome.

Quick Start

Validate the current Git branch name and report whether a matching spec directory exists for its prefix.

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 branch names against feature branch naming conventions?

To validate Git branch names, the Skill checks the active branch against sequential and timestamp prefixes to confirm compliance with team conventions. It verifies the branch name pattern matches the required format and reports any naming mismatches during development.

How do I check if a matching spec directory exists for my Git branch prefix?

To check for a matching spec directory, the Skill reads the branch prefix and searches for a corresponding specs/<prefix>-* directory within the spec-kit project structure. It reports success if the directory exists or issues a warning if the specification files are missing.

Does branch naming validation work in CI checks without Git available?

Yes, branch naming validation works in CI checks without Git by falling back to the SPECIFY_FEATURE environment variable. When Git is unavailable, the Skill reads this variable to determine the feature prefix and validate the expected spec directory structure.

What Git branch naming patterns are supported for spec-kit project structure validation?

For spec-kit project structure validation, the Skill supports sequential naming patterns like 001-feature and timestamp patterns like 20260319-143022-feature. It performs pattern matching on these prefixes to ensure branches align with the repository's specification directories.

Why does my feature branch validation report a missing specification directory warning?

Feature branch validation reports a missing specification directory warning when the branch prefix does not match any existing specs/<prefix>-* directory in the .specify path. This indicates a naming mismatch between the Git branch and the actual specification files created.