validating-setup-commands

Validate CLAUDE.md setup commands before creating worktrees.

19|Updated Oct 21, 2025
One-click install
npx skills add https://github.com/arittr/spectacular --skill validating-setup-commands
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: validating-setup-commands
Source: https://github.com/arittr/spectacular/tree/main/skills/validating-setup-commands
Command: npx skills add https://github.com/arittr/spectacular --skill validating-setup-commands

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill prevents cryptic dependency failures by validating setup commands before creating worktrees, ensuring projects have proper installation documentation.

Core Features & Use Cases

  • Early Validation: Detects missing setup commands before worktree creation, not during task execution.
  • Clear Error Guidance: Provides exact CLAUDE.md format examples when setup commands are missing.
  • Use Case: When creating a new worktree for a Node.js project, this Skill validates that npm install is defined in CLAUDE.md before proceeding.

Quick Start

Use the validating-setup-commands skill to check if the current repository has proper setup commands defined in CLAUDE.md.

Frequently Asked Questions about validating-setup-commands

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

FAQPage Schema
How do I prevent worktree failures caused by missing dependencies?

Validate setup commands in your CLAUDE.md file before creating worktrees. The validating-setup-commands Skill checks that your CLAUDE.md Setup section defines both a required install command (like `npm install`) and optional postinstall command, catching dependency issues before worktree creation fails.

What setup commands does CLAUDE.md need to define?

CLAUDE.md requires an install command in the Setup section—such as `npm install`, `pip install`, or equivalent for your package ecosystem—and optionally a postinstall command for additional configuration. This Skill validates both are present and properly formatted.

Can I use this Skill with multiple package ecosystems?

Yes, this Skill works across package ecosystems including Node.js, Python, and others. It extracts and validates the install and postinstall commands you define in CLAUDE.md regardless of your project's package manager.

What error messages does the Skill provide when setup commands are missing?

The Skill emits clear, actionable error messages that show exactly which setup commands are missing from CLAUDE.md and provide format examples so you can add them correctly before proceeding with worktree creation.

When should I run setup validation before creating worktrees?

Run validation early in your worktree creation workflow to detect missing install or postinstall commands in CLAUDE.md. This prevents cryptic dependency failures later and ensures every worktree starts with proper installation documentation.

Does this Skill work if my project doesn't use worktrees?

This Skill is designed for projects using worktrees with a CLAUDE.md Setup section. If your project doesn't use worktrees, you won't need this validation—focus on documenting setup commands in CLAUDE.md for local development instead.