valid-skill

Validate skill directories against the Agent Skills standard.

484|76|Updated Oct 23, 2025
One-click install
npx skills add https://github.com/bastani-inc/atomic --skill valid-skill-bastani-inc
Or copy as Structured Prompt for Agentā–¼
Please help me install this Agent Skill.
Skill: valid-skill
Source: https://github.com/bastani-inc/atomic/tree/main/packages/coding-agent/test/fixtures/skills/valid-skill
Command: npx skills add https://github.com/bastani-inc/atomic --skill valid-skill-bastani-inc

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you verify that a directory is a valid Agent Skill and understand the minimum structure required for discovery and activation.

Core Features & Use Cases

  • Skill Validation: Checks for a root SKILL.md file and required frontmatter fields.
  • Standard Compliance: Confirms the skill is self-contained and usable as an entry point.
  • Use Case: Use it when testing new skills, auditing fixtures, or teaching the Agent Skills format.

Quick Start

Ask the assistant to inspect the provided skill directory and confirm whether it meets the Agent Skills standard.

Frequently Asked Questions about valid-skill

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

FAQPage Schema
How do I validate a directory against the Agent Skills standard?ā–¼

A valid Agent Skills directory requires a root SKILL.md file with mandatory YAML frontmatter fields and a clear operational body. This structure ensures the skill is self-contained and discoverable for agent activation.

What makes a skill self-contained and usable as an entry point?ā–¼

A skill is self-contained when it exposes a root SKILL.md file with mandatory frontmatter and a clear operational body. Optional component directories can be included, but the root file is required for the skill to function as an entry point.

How do I audit a repository for SKILL.md frontmatter compliance?ā–¼

You audit repository compliance by scanning for a root SKILL.md file and verifying that required frontmatter fields are present. This process confirms whether each skill directory meets the standard for fixture testing and onboarding checks.

Do I need YAML metadata in SKILL.md for fixture testing?ā–¼

Yes, YAML metadata is required in SKILL.md for fixture testing. The mandatory frontmatter fields ensure the skill directory is recognized as a valid, self-contained entry point during automated testing and repository audits.

Can I use this skill validation for onboarding checks with optional component directories?ā–¼

Yes, skill validation applies to onboarding checks and correctly identifies optional component directories. It ensures the root SKILL.md and mandatory frontmatter are present while allowing additional component structures to exist alongside them.