{skill-name}

Validate Skill Units by checking SKILL.md and YAML frontmatter.

413|64|Updated Feb 7, 2023

Search Tags:#markdown #assets #scripts #skill #frontmatter #references #unit-discovery

Ready to run

npx skills add https://github.com/christianhelle/refitter --skill skill-name-christianhelle

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: {skill-name}
Source: https://github.com/christianhelle/refitter/tree/main/.squad
Command: npx skills add https://github.com/christianhelle/refitter --skill skill-name-christianhelle

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Clarifies the purpose and boundaries of a Skill by outlining its entry requirements, metadata, and activation flow.

Core Features & Use Cases

Establishes a self-contained Skill Unit validated by SKILL.md presence and YAML frontmatter.
Supports optional resources (scripts, references, assets) loaded on demand as directed by SKILL.md.
Enables automated discovery, indexing, and activation of skills across the repository.

Quick Start

Follow the Skill's SKILL.md at the root to ensure the unit is valid and ready for discovery.

Frequently Asked Questions about {skill-name}

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

FAQPage Schema

How do I validate a markdown skill unit for agent discovery?▼

To validate a markdown skill unit, ensure a SKILL.md file exists at the root directory and contains YAML frontmatter with both a name and description. The system uses this frontmatter for automated unit discovery and indexing across the repository.

What is the structure required for defining a skill using markdown frontmatter?▼

Defining a skill requires a root SKILL.md file with YAML frontmatter specifying the name and description. The markdown body serves as operational instructions, and you can optionally include scripts, references, and assets directories for on-demand resource loading.

Can I load external scripts and references on demand within a skill?▼

Yes, a skill unit can optionally contain resources in scripts, references, and assets directories. The SKILL.md file directs the system to load these specific resources on demand when the skill is activated and operational instructions require them.

Does unit discovery require the SKILL.md file to be at the repository root?▼

Yes, unit discovery requires the SKILL.md file to be located at the root of the skill unit. The system checks for this file's presence and validates its YAML frontmatter to enable automated indexing and activation.

What limitations exist when organizing assets and scripts for skill units?▼

Skill units are limited to loading optional assets, scripts, and references exclusively from their designated directories as directed by SKILL.md. The markdown body acts as the operational instructions, meaning resources outside this structure are not discovered.