skills.rest
chinawrj
chinawrjCOMMUNITY
Explore all skills by this author →
GitHub

skill-authoring-guide

Guide SKILL.md authoring with templates and validation workflows.

Updated Jan 12, 2026
Search Tags:#templates#documentation#guidelines#best-practices#yaml-frontmatter#agent-skills#skill-authoring
One-click install
npx skills add https://github.com/chinawrj/agent-skills-stock --skill skill-authoring-guide-chinawrj
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-authoring-guide
Source: https://github.com/chinawrj/agent-skills-stock/tree/main/.github/skills/skill-authoring-guide
Command: npx skills add https://github.com/chinawrj/agent-skills-stock --skill skill-authoring-guide-chinawrj

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This guide provides a structured approach to creating Skill units that conform to the Agent Skills open standard, ensuring consistent definitions and formats.

Core Features & Use Cases

  • Official SKILL.md formatting guidance, including mandatory frontmatter and optional directories.
  • Templates, examples, and best practices to accelerate skill authoring and validation.
  • Clear discovery metadata to improve indexing and reuse across projects.

Quick Start

Create a new skill folder following the official SKILL.md template and populate it with frontmatter and the required sections.

Frequently Asked Questions about skill-authoring-guide

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

FAQPage Schema
How do I write an Agent Skill that complies with the open standard?▼

To write a compliant Agent Skill, draft a SKILL.md file using structured templates that populate mandatory YAML frontmatter, such as name and description, alongside recommended body sections.

What is the required YAML frontmatter for a SKILL.md file?▼

The required YAML frontmatter for a SKILL.md file mandates specific name and description fields to ensure consistent definitions, proper indexing, and reuse across projects.

How do I validate agent skill metadata and directory structure?▼

You validate agent skill metadata by applying best-practice guidelines and validation workflows that check consistent naming, frontmatter requirements, and optional directory structures.

What should be included in the body and references of an agent skill?▼

The body and references of an agent skill should include recommended content templates, practical examples, and best practices to accelerate skill authoring and ensure standard compliance.

When do I need to use a structured guide for authoring agent skills?▼

You need a structured guide for authoring agent skills when drafting SKILL.md files, templates, and examples to ensure consistent naming, accurate descriptions, and proper metadata encapsulation.

Can I use optional directories when structuring my agent skill assets?▼

Yes, you can use optional directories to organize assets within your agent skill, as the standard allows flexible directory structures while maintaining required frontmatter compliance.

Related Skills

Explore More Software Engineering Skills→
ldzhhxxldzhhxx
1

hermes-agent-skill-authoring

Create and validate SKILL.md files for the Hermes Agent repository.

Community
Intermediate
mkgs-databricks-demosmkgs-databricks-demos
1

databricks-mlflow-evaluation

Locate root SKILL.md files and extract YAML frontmatter metadata into YAML documents.

Official
Advanced
p-iknowp-iknow
1

doc-frontmatter

Generate and validate YAML frontmatter for Markdown documentation files.

Community
Intermediate
SterlingChinSterlingChin
1.0k

skill-creator

Scaffold new MARVIN skills with SKILL.md frontmatter and directory structures.

Community
Basic