kata-skill-validate

Name: kata-skill-validate
Availability: InStock
Author: Guardia

Validate skill project directories against Lex structure and frontmatter rules.

Updated Sep 3, 2025

Search Tags:#project structure #python #GitHub #YAML #skill validation #frontmatter #CI checks

Ready to run

npx skills add https://github.com/guardiatechnology/design-system --skill kata-skill-validate

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: kata-skill-validate
Source: https://github.com/guardiatechnology/design-system/tree/main/.claude/skills/kata-skill-validate
Command: npx skills add https://github.com/guardiatechnology/design-system --skill kata-skill-validate

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

It helps you catch structural and metadata mistakes in a skill project early, before it breaks downstream packaging or discovery workflows.

Core Features & Use Cases

Deterministic project validation: Verifies the skill directory against the expected Lex project structure and Anthropic frontmatter requirements.
Rule-based violation reporting: Runs a single-pass validator that returns detailed violations (rule, severity, file, message) and classifies results as ok, ok-with-warnings, or failed.
Orchestrates without altering files: Executes the validator script and reports issues exactly as produced, without filtering or mutating the project.

Quick Start

Run the validator against your skill folder, such as kata-skill-validate skills/kata-your-skill --format text.

Frequently Asked Questions about kata-skill-validate

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

FAQPage Schema

How do I validate SKILL.md frontmatter and project structure in CI checks?▼

You validate SKILL.md frontmatter and project structure by running a deterministic validator script against your skill directory, which checks required files, naming conventions, and cross-reference integrity, returning exit code 1 for errors and 0 for warnings.

What is skill validation for GitHub project directories?▼

Skill validation for GitHub project directories is a deterministic readiness check that verifies a skill folder conforms to expected Lex structure, ensuring SKILL.md frontmatter includes valid name and description fields before downstream packaging or discovery workflows.

How do I check if my Python skill project meets required frontmatter rules?▼

You check your Python skill project by executing the validator against your skill folder path, such as running the script with your directory and a text format flag, which reports frontmatter violations with severity levels without altering any files.

Does the skill validator modify files during project structure checks?▼

The skill validator does not modify files during project structure checks; it executes a single-pass validator that orchestrates reporting of rule violations exactly as produced, without filtering or mutating the project directory.

What severity levels does the YAML frontmatter validator report?▼

The YAML frontmatter validator reports violations with specific severity levels and classifies overall results as ok, ok-with-warnings, or failed, ensuring errors trigger an exit code 1 while warnings-only scenarios return exit code 0 for CI gating.

Can I use this validation script for repository automation and CI-style gating?▼

You can use this validation script for repository automation and CI-style gating because it applies deterministic checks to a specific skill root directory path, ensuring cross-reference integrity and required frontmatter fields pass before merging or packaging.