Verified:GitHub

[skill-name]

Document AI capabilities in SKILL.md files with YAML frontmatter and instructions.

Updated Mar 24, 2026

Search Tags:#knowledge base #YAML frontmatter #instruction design #agent workflows #skill documentation #repository indexing

Ready to run

npx skills add https://github.com/Icebane84/Synarche_Workshop --skill skill-name-icebane84

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: [skill-name]
Source: https://github.com/Icebane84/Synarche_Workshop/tree/main/incoming/test-skill
Command: npx skills add https://github.com/Icebane84/Synarche_Workshop --skill skill-name-icebane84

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a scaffold for documenting an AI capability by defining discoverable metadata and a place for operational instructions, so the skill can be activated consistently.

Core Features & Use Cases

Discoverability via YAML frontmatter: Supplies the required fields (name and description) to help systems index the skill.
Operational instruction body: Offers a structured section where you can write step-by-step guidance for how the skill should be executed.
Usage section template: Establishes a clear place to describe how to invoke the skill and what output to expect.

Quick Start

Edit the SKILL.md frontmatter and replace the placeholder instructions with the actual task steps you want the AI to follow.

Frequently Asked Questions about [skill-name]

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

FAQPage Schema

How do I document an AI capability as a discoverable skill unit?▼

You document an AI capability as a discoverable skill unit by combining YAML frontmatter metadata with a Markdown instruction body. This creates a standardized skill runbook for repository indexing.

What YAML frontmatter is required to index a skill in a repository?▼

The required YAML frontmatter to index a skill includes at least the name and description fields. These metadata fields ensure the skill is discoverable and can be activated consistently when needed.

How do I create a standard runbook for agent workflows?▼

To create a standard runbook for agent workflows, you edit the SKILL.md frontmatter and replace placeholder instructions with actual step-by-step task guidance. This establishes a clear usage section for invoking the skill.

Can I use this skill scaffolding without any prior dependencies?▼

Yes, you can use this skill scaffolding without any prior dependencies. It requires only a root SKILL.md file containing the required metadata fields and operational instructions to function.

What is the best way to structure skill documentation for repository indexing?▼

The best way to structure skill documentation for repository indexing is by using YAML frontmatter for metadata and a structured Markdown section for operational instructions. This standardizes how the skill is discovered and executed.