speckit-git-validate

Validate Git feature branch names against sequential or timestamp patterns.

8|1|Updated Sep 19, 2008
One-click install
npx skills add https://github.com/juvenal/openrender --skill speckit-git-validate-juvenal
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-git-validate
Source: https://github.com/juvenal/openrender/tree/main/.cursor/skills/speckit-git-validate
Command: npx skills add https://github.com/juvenal/openrender --skill speckit-git-validate-juvenal

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the risk of misnamed Git feature branches that break spec-kit project workflows, ensuring all branches align with required naming patterns for seamless specification tracking.

Core Features & Use Cases

  • Branch Pattern Validation: Checks if the current Git branch matches required sequential (e.g., 001-feature-name) or timestamp (e.g., 20260319-143022-feature-name) naming conventions.
  • Spec Directory Verification: Confirms a corresponding spec directory exists under the specs/ folder for valid feature branches to maintain proper linkage between branches and their corresponding specifications.
  • Use Case: Development teams using the spec-kit framework can run this validation during development to catch misnamed branches early, preventing broken associations between branches and their corresponding specifications before merging.

Quick Start

Use the speckit-git-validate skill to check if your current Git branch follows the required feature branch naming conventions and has a matching spec directory.

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 feature branch naming conventions for spec-kit projects?

To validate Git feature branch naming conventions, check the current branch against required sequential or timestamp patterns. This ensures spec-kit branches follow standards like 001-feature-name or 20260319-143022-feature-name for proper specification tracking.

What Git branch naming patterns are supported for spec-kit workflows?

Git branch naming patterns supported for spec-kit workflows include sequential formats like 001-feature-name and timestamp formats like 20260319-143022-feature-name. These patterns maintain proper linkage between branches and their corresponding specifications.

How does spec directory verification work for Git feature branches?

Spec directory verification confirms a corresponding spec directory exists under the specs/ folder for valid feature branches. This maintains proper linkage between Git branches and their corresponding specifications during development workflows.

Can I validate spec-kit feature branches without Git installed in the working directory?

Yes, you can validate spec-kit feature branches without Git by using the SPECIFY_FEATURE environment variable. This fallback validation mechanism allows branch pattern checking when Git is not available in the current working directory.

Why do misnamed Git feature branches break spec-kit project workflows?

Misnamed Git feature branches break spec-kit workflows by failing to match required sequential or timestamp patterns, which prevents proper association between branches and their corresponding spec directories under the specs/ folder.

When should I run Git branch validation in a spec-kit development workflow?

Run Git branch validation during spec-kit development to catch misnamed branches early before merging. This prevents broken associations between feature branches and their corresponding spec directories, ensuring seamless specification tracking.