speckit-git-validate

Validate current Git branch names against feature-branch patterns and locate matching specs paths.

180|11|Updated Apr 11, 2026
One-click install
npx skills add https://github.com/serverless-dna/tendril --skill speckit-git-validate-serverless-dna
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-git-validate
Source: https://github.com/serverless-dna/tendril/tree/main/.agents/skills/speckit-git-validate
Command: npx skills add https://github.com/serverless-dna/tendril --skill speckit-git-validate-serverless-dna

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Validates that the current Git branch name conforms to established feature-branch naming conventions, reducing misnamed work and misrouted changes.

Core Features & Use Cases

  • Pattern validation: Detects branches matching sequential (000- prefix) or timestamp (YYYYMMDD-HHMMSS- prefix) formats.
  • Spec discovery: Verifies existence of a corresponding spec directory under specs/ for the detected prefix.
  • Graceful degradation: If Git is unavailable, reads SPECIFY_FEATURE or outputs a warning.

Quick Start

Run the skill on a Git repository to verify that the current branch matches the required 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 my Git branch name against feature-branch conventions?

To validate a Git branch name against feature-branch conventions, run this skill in your repository. It checks the current branch against sequential (000-) or timestamp (YYYYMMDD-HHMMSS-) prefixes and prints clear results with guidance for next steps.

What feature-branch naming patterns are supported for Git workflows?

Supported Git feature-branch naming patterns include sequential formats with a 000- prefix and timestamp formats with a YYYYMMDD-HHMMSS- prefix. The skill verifies your current branch matches these established conventions to prevent misrouted changes.

Can I check for a corresponding spec directory under specs/ based on my branch name?

Yes, you can check for a corresponding spec directory under specs/. After validating the branch prefix, the skill performs spec discovery to verify the existence of a matching specs path for the detected sequential or timestamp prefix.

What happens if Git is unavailable when checking feature-branch naming conventions?

If Git is unavailable when checking feature-branch naming conventions, the skill gracefully degrades by reading the SPECIFY_FEATURE environment variable as a fallback. If that is missing, it outputs a warning instead of failing.

Why do I need to enforce feature-branch naming patterns in my repository?

You need to enforce feature-branch naming patterns to prevent misnamed work and misrouted changes in your repository. Validating branch names against sequential or timestamp conventions ensures consistency and locates matching spec paths.