valid-skill

Validate skill units against SKILL.md and YAML frontmatter requirements.

193|17|Updated Jan 16, 2026
One-click install
npx skills add https://github.com/pproenca/dot-skills --skill valid-skill-pproenca
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: valid-skill
Source: https://github.com/pproenca/dot-skills/tree/main/tests/fixtures/valid-skill
Command: npx skills add https://github.com/pproenca/dot-skills --skill valid-skill-pproenca

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill serves as a reference for the expected format of a valid skill unit, ensuring proper validation and testing.

Core Features & Use Cases

  • Validation Reference: Provides a clear example of a correctly structured skill.
  • Testing Purposes: Used to verify the functionality of validation tools and processes.

Quick Start

Use the valid-skill to test the skills-ref validator.

Frequently Asked Questions about valid-skill

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

FAQPage Schema
How do I validate the structure of an AI agent skill unit?

To validate an AI agent skill unit, verify its structure against official definitions, ensuring the mandatory SKILL.md file is present and YAML frontmatter meets formatting requirements for discoverability.

What is the required format for a valid skill unit?

A valid skill unit requires a SKILL.md file and properly structured YAML frontmatter. This format serves as a reference to ensure proper validation and testing of AI agent skill management systems.

How do I test my skill validation tools?

You can test skill validation tools by running them against a known valid reference skill. This verifies that your validation processes correctly identify properly structured SKILL.md files and frontmatter.

Why does my skill unit fail discoverability checks?

Skill units fail discoverability checks when they lack the mandatory SKILL.md file or contain improperly formatted YAML frontmatter, violating the official structural definitions required for AI agent skill management.

Do I need YAML frontmatter for skill unit testing?

Yes, YAML frontmatter is mandatory for skill unit testing. It ensures the skill adheres to official formatting definitions, enabling validation tools to correctly parse and verify the skill structure.