skill-validate

Validate SKILL.md files for structural errors and broken cross-references.

176|13|Updated Mar 2, 2026
One-click install
npx skills add https://github.com/techygarg/lattice --skill skill-validate-techygarg
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-validate
Source: https://github.com/techygarg/lattice/tree/main/dev-skills/skill-validate
Command: npx skills add https://github.com/techygarg/lattice --skill skill-validate-techygarg

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Validate SKILL.md files for structural integrity, ensure conformance to all tier conventions (atoms, molecules, refiners), and catch broken cross-references before they reach the repo.

Core Features & Use Cases

  • Validates YAML frontmatter presence and correctness, name alignment with folder, required sections, and cross-reference integrity.
  • Applies to atoms, molecules, and refiners to detect structural issues early in the workflow.
  • Produces a detailed findings report with per-skill PASS/FAIL results and actionable fixes, sourcing conventions from CLAUDE.md and rules from references/convention-rules.md.

Quick Start

Run this validator against a SKILL.md to generate a findings report with actionable fixes.

Frequently Asked Questions about skill-validate

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

FAQPage Schema
How do I validate SKILL.md frontmatter and cross-references for convention errors?

To validate SKILL.md frontmatter and cross-references, apply a validator to check YAML correctness, folder-name alignment, and structural integrity. It reads conventions from CLAUDE.md and rules from references/convention-rules.md to output a per-skill findings report with actionable fixes.

What is the best way to lint SKILL.md files before they reach the repo?

The best way to lint SKILL.md files before they reach the repo is to run a structural validator that detects broken cross-references and convention violations. It applies tier-specific checks for atoms, molecules, and refiners to catch issues early in the workflow.

How do I check if my SKILL.md conforms to Lattice tier conventions?

To check if your SKILL.md conforms to Lattice tier conventions, run a validation check against atoms, molecules, and refiners. It verifies required sections and structural formats, producing a detailed PASS or FAIL findings report with actionable fixes.

Can I validate multiple SKILL.md files at the same time?

Yes, you can validate multiple SKILL.md files at the same time. The validator applies to one or more files, checking folder-name alignment and cross-reference integrity across all provided files to generate a comprehensive per-skill findings report.

Why does my SKILL.md validation report show a FAIL for broken cross-references?

Your SKILL.md validation report shows a FAIL for broken cross-references because internal links point to missing or incorrectly named targets. The validator detects these structural errors and outputs actionable fixes to correct the linking paths.