speckit-git-validate

Validate Git branch names against feature branch naming conventions.

1.0k|514|Updated Jan 21, 2026
One-click install
npx skills add https://github.com/unipds-engenharia-de-ia-aplicada/engenharia-de-software-com-ia-aplicada --skill speckit-git-validate-unipds-engenharia-de-ia-aplicada
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-git-validate
Source: https://github.com/unipds-engenharia-de-ia-aplicada/engenharia-de-software-com-ia-aplicada/tree/main/lives/2026-05-27/001-pos-live/.claude/skills/speckit-git-validate
Command: npx skills add https://github.com/unipds-engenharia-de-ia-aplicada/engenharia-de-software-com-ia-aplicada --skill speckit-git-validate-unipds-engenharia-de-ia-aplicada

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill checks whether the current Git branch follows the expected feature-branch naming rules and helps teams avoid inconsistent branch names.

Core Features & Use Cases

  • Branch Validation: Verifies sequential or timestamp-based branch names against the required patterns.
  • Spec Directory Check: Looks for a matching spec directory prefix so branch work stays aligned with the project structure.
  • Graceful Fallbacks: Skips safely when Git is unavailable and can use the SPECIFY_FEATURE environment variable instead.
  • Use Case: Use it before starting or reviewing a task to confirm the branch naming is compliant and the corresponding spec folder exists.

Quick Start

Ask the Skill to validate the current branch name and confirm whether a matching spec 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 a Git feature branch name against naming conventions?

Git branch validation checks the current branch name against sequential or timestamp-based feature branch patterns. It confirms compliance with naming conventions and looks for a matching spec directory prefix to keep work aligned with project structure.

Does branch validation work when Git is unavailable?

Branch validation skips safely when Git is unavailable by falling back to the SPECIFY_FEATURE environment variable. This allows you to verify feature branch naming conventions and spec directory prefixes without direct Git access.

What is a spec directory prefix in feature branch validation?

A spec directory prefix is a project folder structure marker that aligns feature branch work with its corresponding specifications. Branch validation looks for this matching directory to ensure branch work stays organized within Spec Kit repositories.

Can I use timestamp-based branch names with Spec Kit repositories?

Yes, timestamp-based branch names are fully supported during validation. The tool applies pattern matching to verify both sequential and timestamp-based feature branches in Spec Kit repositories.

Why does my feature branch validation fail to find the matching spec folder?

Feature branch validation fails to find the spec folder when the branch name lacks the required spec directory prefix. Ensure your branch naming conventions include the correct prefix to align with the project structure.