speckit-git-validate

Validate current Git branch names against feature-branch naming conventions.

Updated Apr 26, 2026
One-click install
npx skills add https://github.com/victorevh/orbitarium-engine-sdd --skill speckit-git-validate-victorevh
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-git-validate
Source: https://github.com/victorevh/orbitarium-engine-sdd/tree/main/.cursor/skills/speckit-git-validate
Command: npx skills add https://github.com/victorevh/orbitarium-engine-sdd --skill speckit-git-validate-victorevh

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Validate current Git branch names against predefined feature-branch naming conventions to ensure consistency across teams and pipelines.

Core Features & Use Cases

  • Pattern-based validation for sequential prefixes like 001-feature-name and timestamp-like prefixes such as 20260319-143022-feature-name.
  • Graceful degradation when Git is not available or the repository is not detected, with an optional SPECIFY_FEATURE fallback.
  • Execution feedback including current branch status and whether a corresponding spec directory exists under specs/.

Quick Start

Run speckit-git-validate to verify that the current Git branch name matches the required feature-branch 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 Git branch names against feature-branch naming conventions?

You can validate feature-branch naming conventions by running the Skill to check the current Git branch name against sequential or timestamp patterns. It reports whether the branch matches and if a corresponding spec directory exists under specs/.

What is the expected naming convention for feature branches in a Git repository?

The expected naming convention requires branch names to use sequential prefixes like 001-feature-name or timestamp prefixes like 20260319-143022-feature-name. This ensures consistency across teams and pipelines in Git repositories.

Can I enforce branch name validation when Git is not available?

Yes, you can enforce branch name validation without Git by using the SPECIFY_FEATURE fallback. The Skill gracefully handles cases where Git is not available or the current directory is not a Git repository.

Does the branch name validator check for corresponding spec directories?

Yes, the validator checks whether a matching spec directory exists under specs/. It provides execution feedback that includes the current branch status and confirms if the corresponding spec directory is present.

What happens if I run the Git branch validator outside of a Git repository?

If you run the validator outside of a Git repository, it gracefully degrades instead of throwing an error. It handles the missing repository context smoothly and can use the SPECIFY_FEATURE fallback to continue validation.

Why should teams use timestamp-based prefixes for feature branch names?

Teams use timestamp-based prefixes like 20260319-143022-feature-name to ensure chronological sorting and prevent naming collisions. Validating these patterns maintains consistency and traceability across development pipelines.