test-skill

Validates SKILL.md frontmatter and packaging with optional references directories.

Updated Feb 12, 2026
One-click install
npx skills add https://github.com/antstanley/skill-builder --skill test-skill-antstanley
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: test-skill
Source: https://github.com/antstanley/skill-builder/tree/main/testdata/fixtures/valid_skill
Command: npx skills add https://github.com/antstanley/skill-builder --skill test-skill-antstanley

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This test skill serves as a minimal, well-formed example to validate the skill-builder CLI's parsing, frontmatter validation, and packaging flow for real skills. It helps ensure that the tooling correctly reads the mandatory SKILL.md, validates the required fields, and handles optional references directories during packaging and validation.

Core Features & Use Cases

  • Provides a minimal SKILL.md frontmatter with a name and description to exercise parsing and validation.
  • Includes a references/ directory to test optional content handling without requiring external dependencies.
  • Enables end-to-end testing of the skill lifecycle (validate and package) using the CLI.

Quick Start

Run the CLI to validate this test skill using the SKILL.md present in this directory.

Frequently Asked Questions about test-skill

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

FAQPage Schema
How do I validate skill packaging using a CLI?

To validate skill packaging using a CLI, run the validator against a minimal SKILL.md file to exercise frontmatter parsing and test optional references directory handling. This ensures parsing and packaging tooling correctly read mandatory fields.

What is frontmatter validation for skill definitions?

Frontmatter validation for skill definitions is the process of checking the basic metadata fields in a SKILL.md file to ensure they meet required structural standards. It exercises parsing logic to confirm mandatory name and description fields are present.

How do I test a skill lifecycle end-to-end?

To test a skill lifecycle end-to-end, apply a minimal well-formed example to automated test scenarios that import a basic SKILL.md and an optional references folder. This validates both the packaging and validation flows without external dependencies.

Do I need external dependencies to test skill parsing?

No, you do not need external dependencies to test skill parsing. The validation uses a minimal well-formed example with a SKILL.md file and an optional references directory to test content handling independently.

What is the best way to check SKILL.md structure correctness?

The best way to check SKILL.md structure correctness is to run an automated validation test that exercises the frontmatter fields and content structure. This confirms the skill definition meets packaging requirements.

Why does my skill packaging fail frontmatter validation?

Skill packaging fails frontmatter validation when the SKILL.md file is missing mandatory fields like name or description, or when the content structure does not meet the basic parsing requirements expected by the tooling.