validate-registry

Validate feature registry consistency against Git branches and filesystem state.

Updated Dec 22, 2025
One-click install
npx skills add https://github.com/royhenengel/Claude-Customizations --skill validate-registry
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: validate-registry
Source: https://github.com/royhenengel/Claude-Customizations/tree/main/skills/Planning/validate-registry
Command: npx skills add https://github.com/royhenengel/Claude-Customizations --skill validate-registry

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill ensures that your feature registry accurately reflects your project's actual development state, preventing inconsistencies and identifying potential issues before they cause problems.

Core Features & Use Cases

  • Consistency Checks: Verifies that registered branches and worktrees exist and are correctly linked.
  • Stale Entry Detection: Identifies registry entries that no longer correspond to active development work.
  • Unregistered Worktree Identification: Flags any active Git worktrees that are missing from the registry.
  • Audit and Fix Modes: Can perform read-only audits or attempt to automatically correct identified issues.
  • Use Case: Before a release, run this skill to confirm that all features marked as 'active' have corresponding Git branches and worktrees, and that no stray worktrees exist.

Quick Start

Run /validate-registry to audit your feature registry for inconsistencies.

Frequently Asked Questions about validate-registry

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I validate my feature registry against local Git branches?

To validate a feature registry against local Git branches, you run an audit process that checks the `workspace/STATE.md` file for status mismatches and stale entries. This verifies registered branches and worktrees exist and are correctly linked.

What is the best way to detect unregistered Git worktrees in my project?

Detecting unregistered Git worktrees involves auditing your feature registry to flag any active worktrees missing from the tracking records. This identifies active development work that lacks proper registry documentation.

Can I automatically fix feature registry inconsistencies and stale entries?

Yes, you can automatically fix feature registry inconsistencies using an automated fix mode. This mode corrects identified issues like stale entries and status mismatches directly in the `workspace/STATE.md` file after running an audit.

Why does my feature registry show stale entries for active development work?

A feature registry shows stale entries when registered branches and worktrees no longer correspond to active development work. This happens when the registry state in `workspace/STATE.md` diverges from actual Git branch and filesystem state.

Does the registry validation process support read-only auditing?

Yes, the registry validation process supports read-only auditing. You can perform consistency checks to verify registered branches and worktrees exist and are correctly linked without making any automated changes.

When do I need to run a feature registry consistency check before a release?

You need to run a feature registry consistency check before a release to confirm all features marked as active have corresponding Git branches and worktrees. This prevents inconsistencies and ensures no stray worktrees exist.