What problem does it solve?
Automates pre-review checks for Team Lead products by catching security leaks, unsafe paths, and common formatting/structure issues before anything is handed over for review.
Core Features & Use Cases
- Security and secrets scanning: Detects personal data markers (names, IDs, addresses, phones, usernames) and token-like strings in skill/material/GitHub files.
- Path and style linting: Flags absolute paths (e.g., /Users/... /home/... /root/) and style problems like long/medium dashes (—/–).
- Type-specific validation:
- Skill: Validates
SKILL.md YAML frontmatter (requires name/description), checks triggers presence, size limits, and optional references integrity.
- Group material: Verifies expected dual format patterns (MD + PDF + AGENT.md) and required section headers.
- GitHub project: Confirms presence of core documentation files like README.md and recommends LICENSE/INSTALL/.gitignore.
- Use cases: Use it in a pipeline step to reduce manual grep/review time and improve consistency across skills and submissions.
Quick Start
Run the validator on the product folder you want to check, then iterate with auto-fixes for dash style if needed (for example: python3 skills/product-validator/scripts/validate.py <path> --fix).