project-validator

Validate project structure, dependencies, and configuration with a Python script.

4|Updated Dec 11, 2025
One-click install
npx skills add https://github.com/tomada1114/tomada-claude-plugins --skill project-validator
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: project-validator
Source: https://github.com/tomada1114/tomada-claude-plugins/tree/main/claude-dev-kit/skills/claudecode-skill-creating/examples/3-skill-with-scripts
Command: npx skills add https://github.com/tomada1114/tomada-claude-plugins --skill project-validator

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This skill validates common project configurations and structure. It demonstrates how to use scripts for deterministic validation tasks.

Core Features & Use Cases

  • Deterministic checks of essential files (package.json, README.md, .gitignore)
  • Dependency and environment validation (node_modules, environment variables)
  • Onboarding and pre-deployment health checks
  • Troubleshooting guidance and actionable results

Quick Start

Run the validation from the project root to generate a health report:

  • Run: python scripts/validate.py
  • For onboarding a new project, run: bash scripts/setup.sh

Frequently Asked Questions about project-validator

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

FAQPage Schema
How do I validate my project structure and dependencies?

Project validation checks essential files like package.json, README.md, and .gitignore, plus node_modules and environment setup. Run python scripts/validate.py from your project root to generate a health report identifying missing or misconfigured elements.

What does project health validation check for?

Health validation performs deterministic checks on package.json configuration, dependency installation, environment variables, git repository status, and README documentation. It surfaces gaps in project structure before onboarding or deployment.

Can I use project validation during onboarding?

Yes. Run bash scripts/setup.sh to validate and set up a new project, then python scripts/validate.py to generate a health report. This ensures dependencies, environment, and configuration are correct before team members start working.

What environment does project validation require?

Project validation requires Python 3 and works with Node.js projects containing package.json, .git, and node_modules. It runs deterministic checks without external dependencies.

How do I troubleshoot configuration issues in my project?

Run python scripts/validate.py to identify missing files, incorrect package.json structure, uninstalled dependencies, or environment variable gaps. The health report provides actionable results for each issue found.

Can project validation work with pre-deployment checks?

Yes. Validation is designed for pre-deployment health checks alongside onboarding. Run it to verify package.json, dependencies, and environment setup meet requirements before deploying.