speckit-git-validate

Validate active Git branch names against Spec Kit feature-branch conventions.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/luansilvadb/divi-app --skill speckit-git-validate-luansilvadb
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-git-validate
Source: https://github.com/luansilvadb/divi-app/tree/main/.agents/skills/speckit-git-validate
Command: npx skills add https://github.com/luansilvadb/divi-app --skill speckit-git-validate-luansilvadb

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill ensures that developers adhere to consistent feature-branch naming and automatically validates the current branch against the project's spec-kit conventions, reducing merge conflicts and quality risks.

Core Features & Use Cases

  • Validates the active branch name against sequential patterns like 001-feature-name and timestamp patterns like 20260319-143022-feature-name.
  • Provides graceful degradation when Git is unavailable or not in a repo, including SPECIFY_FEATURE fallback.
  • Reports clear status messages about branch validity and the existence of related spec directories under specs/ to guide workflow.

Quick Start

Run the validation check in a Spec Kit project directory and observe real-time feedback on the active branch.

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 in a Spec Kit project?

Git branch naming validation checks the active branch against sequential (000-) or timestamp (YYYYMMDD-HHMMSS-) formats. It reports clear status messages about branch validity and related spec directories under specs/ to guide your workflow.

What feature-branch naming patterns are supported for Spec Kit workflows?

Spec Kit workflows support sequential patterns like 001-feature-name and timestamp patterns like 20260319-143022-feature-name. Branch validation checks the active Git branch against these formats to ensure consistent feature-branch naming.

Can I validate branch names when Git is unavailable or not a repository?

When Git is unavailable or not in a repository, branch validation gracefully degrades by optionally using the SPECIFY_FEATURE variable as a fallback. It still reports clear status messages about branch validity and spec directory existence.

How do I check if my current Git branch matches sequential or timestamp formats?

Run the validation check in your Spec Kit project directory. It identifies the active Git branch and checks it against sequential (000- prefix) or timestamp (YYYYMMDD-HHMMSS- prefix) formats, triggering lookups in specs/ when appropriate.

Why should I enforce feature-branch naming conventions in Git?

Enforcing feature-branch naming ensures developers adhere to consistent formats and automatically validates branches against spec-kit conventions. This reduces merge conflicts and quality risks by maintaining strict sequential or timestamp patterns.