speckit-git-validate

Validate current Git branch names against feature-branch patterns and spec directories.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Validate that the active Git branch adheres to defined feature-branch naming conventions, preventing drift in branch workflows.

Core Features & Use Cases

  • Checks the current branch against sequential (^[0-9]{3,}-) and timestamp (^[0-9]{8}-[0-9]{6}-) patterns.
  • Gracefully handles cases where Git is unavailable or the repository is not a Git repo, using environment fallback or skipping with warning.
  • Reports whether a corresponding spec directory exists under specs/ and provides actionable messages for non-feature branches.

Quick Start

Run speckit-git-validate to verify the active branch name and locate the related spec in specs when applicable.

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 naming conventions for feature branches?

To validate Git branch naming conventions, this Skill checks the active branch against sequential patterns like ^[0-9]{3,}- and timestamp patterns like ^[0-9]{8}-[0-9]{6}-. It reports whether the branch matches feature-branch naming rules and locates related spec directories under specs/.

What happens when Git is unavailable during branch name validation?

When Git is unavailable or the directory is not a Git repository, branch name validation uses graceful degradation. It falls back to environment variables or skips validation with a warning message, ensuring the workflow continues without hard failures.

Does speckit-git-validate work with spec-kit projects using a .specify directory?

Yes, speckit-git-validate is designed for spec-kit projects containing a .specify/ directory. It confirms whether a corresponding spec directory exists under specs/ when a feature branch is active, providing actionable messages for non-feature branches.

How do I check if a Git feature branch has a matching spec directory?

To check if a Git feature branch has a matching spec directory, run the validation Skill against the active branch name. It verifies the branch matches sequential or timestamp naming patterns, then confirms a corresponding spec directory exists under specs/.

What are the supported feature-branch naming patterns for spec-kit validation?

Spec-kit validation supports two feature-branch naming patterns: sequential prefixes matching ^[0-9]{3,}- (three or more digits) and timestamp prefixes matching ^[0-9]{8}-[0-9]{6}- (YYYYMMDD-HHMMSS format). Branches matching either pattern are validated as feature branches.

Why does my branch name validation report a non-feature branch warning?

Branch name validation reports a non-feature branch warning when the active Git branch does not match either the sequential ^[0-9]{3,}- or timestamp ^[0-9]{8}-[0-9]{6}- patterns. The Skill provides actionable messages indicating the branch does not follow feature-branch naming conventions.