skill-validator

Validate candidate SKILL.md files against a fixed 5-check rubric.

Updated May 13, 2026
One-click install
npx skills add https://github.com/usetheodev/theo-ui --skill skill-validator-usetheodev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-validator
Source: https://github.com/usetheodev/theo-ui/tree/main/.claude/skills/skill-validator
Command: npx skills add https://github.com/usetheodev/theo-ui --skill skill-validator-usetheodev

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This skill validates candidate skill SKILL.md against a fixed, deterministic rubric to prevent insecure or low-quality gate candidates from advancing.

Core Features & Use Cases

  • Enforces a 5-check rubric: frontmatter conformance, citation existence, duplication avoidance, description clarity, and forbidden-pattern checks.
  • Outputs a structured verdict and per-check results to guide promotion, review, or rejection.
  • Works as a deterministic post-generation gate after /skill-writer, with no LLM calls, ensuring cost-free, reproducible validation.

Quick Start

Invoke the validator after a candidate skill is produced to verify conformance and readiness for promotion.

Frequently Asked Questions about skill-validator

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

FAQPage Schema
How do I validate a generated SKILL.md file for frontmatter conformance and safety?

You can validate a generated SKILL.md file by applying a deterministic 5-check rubric that enforces frontmatter conformance, citation existence, duplication avoidance, description clarity, and safety patterns. The validator outputs a structured JSON verdict indicating whether to promote, review, or reject the candidate.

What is a deterministic quality gate for skill metadata and when do I need it?

A deterministic quality gate for skill metadata is a fixed validation rubric that checks candidate SKILL.md files without LLM calls. You need it after generating a candidate skill to prevent insecure or low-quality candidates from advancing, ensuring cost-free and reproducible validation.

Can I use a deterministic validator to check skill descriptions without making LLM API calls?

Yes, you can check skill descriptions without LLM API calls by using a deterministic validator that applies a fixed 5-check rubric to a candidate SKILL.md file. This ensures cost-free and reproducible validation for frontmatter conformance, citations, duplication, clarity, and safety patterns.

How do I enforce citation existence and duplication avoidance in markdown skills?

You enforce citation existence and duplication avoidance in markdown skills by applying a deterministic 5-check rubric to the candidate SKILL.md file. This validation process verifies citations and prevents duplicated content, outputting a structured JSON verdict to guide your promotion decision.

What are the limitations of using a fixed rubric for skill validation?

The limitation of using a fixed rubric for skill validation is that it only evaluates five specific areas: frontmatter conformance, citation existence, duplication avoidance, description clarity, and forbidden patterns. It makes no LLM calls, so it cannot assess semantic nuance or complex logic outside this deterministic 5-check rubric.