skills.rest
huangusaki
huangusakiCOMMUNITY
Explore all skills by this author →
GitHub

skill-guide

Define and validate SKILL.md frontmatter against Aurora's minimal standard.

12|1|Updated Jan 1, 2026
Search Tags:#documentation#yaml#best-practices#skill#frontmatter#aurora
One-click install
npx skills add https://github.com/huangusaki/Aurora --skill skill-guide
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-guide
Source: https://github.com/huangusaki/Aurora/tree/main/skills/00_guide
Command: npx skills add https://github.com/huangusaki/Aurora --skill skill-guide

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires yaml, and includes scripts (resource) components.

What problem does it solve?

This Skill provides practical guidance for creating, refactoring, and auditing SKILL.md files to meet Aurora's official minimal standard and to align with Aurora's extension capabilities.

Core Features & Use Cases

  • Defines the official minimal frontmatter requirements (name and description) and how optional fields extend functionality.
  • Describes the recommended directory layout (scripts/, references/, assets/) and how to place executable steps, references, and assets to support skill execution.
  • Use Case: onboarding new Skills, auditing existing SKILL.md for compliance, and updating Skills to include Aurora extension fields.

Quick Start

Open SKILL.md and ensure it includes the required frontmatter while aligning the body with the described how-to structure.

Frequently Asked Questions about skill-guide

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

FAQPage Schema
What are the required frontmatter fields for a valid SKILL.md file?▼

To validate SKILL.md frontmatter, ensure it includes name and description fields to meet Aurora's minimal standard. The body must contain a How section, while optional fields handle aliases, turns, and component discovery for extended functionality.

How do I structure an Aurora Skill directory for scripts and references?▼

Structure an Aurora Skill directory by placing executable steps in scripts/, supporting documents in references/, and static files in assets/. This modular directory layout supports skill execution alongside the root SKILL.md file.

What is the recommended SKILL.md body structure for Aurora extensions?▼

The recommended SKILL.md body structure must contain a How section to describe execution steps. Optional Aurora extension fields like aliases, turns, and component discovery can be added to enhance skill routing and functionality.

How do I audit an existing SKILL.md file for Aurora compliance?▼

Audit an existing SKILL.md by checking the frontmatter for name and description fields, verifying the body contains a How section, and running safety checks. Ensure optional fields align with Aurora's extension guidelines for full compliance.

Does SKILL.md frontmatter support optional aliases and turns fields?▼

Yes, SKILL.md frontmatter supports optional aliases and turns fields. These Aurora extension capabilities allow you to define alternate invocation names and manage conversational turns beyond the minimal name and description requirements.

Related Skills

Explore More Software Engineering Skills→
P47PhoenixP47Phoenix
2

skill-creator

Scaffold Claude skill directories with SKILL.md templates and validation scripts.

Community
Intermediate
DeDuvaDeDuva
1

{skill-name}

Load and validate SKILL.md frontmatter metadata for agent discovery.

Community
Basic
fdshg693fdshg693

test3

Validate Skill units by checking YAML frontmatter in SKILL.md files.

Community
Basic
kitaekattkitaekatt
3

md-domain

Audit and author SKILL.md, CLAUDE.md, and project documentation for cohesion and cross-reference integrity.

Community
Advanced