writing-skill-md

Validate SKILL.md frontmatter and structure for Skill Units.

1|Updated Jan 23, 2026
One-click install
npx skills add https://github.com/RedKenrok/skills --skill writing-skill-md
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-skill-md
Source: https://github.com/RedKenrok/skills/tree/main/skills/writing-skill-md
Command: npx skills add https://github.com/RedKenrok/skills --skill writing-skill-md

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill ensures every Skill Unit follows the official SKILL.md format by enforcing the presence of a SKILL.md frontmatter containing a name and a description. It clarifies how to structure and document agent skills for consistent discovery and activation.

Core Features & Use Cases

  • Frontmatter validation: Verifies that the root SKILL.md defines required fields like name and description and that the name matches the parent directory.
  • Structure guidance: Explains the expected directory layout (skill-name/, SKILL.md) and how to use optional folders (scripts/, references/, assets/).
  • Compliance auditing: Used to review existing skills for adherence to the skill-authoring spec and prepare them for activation. Use Case: When creating a new skill, use this guide to ensure the Skill Unit is compliant from the start.

Quick Start

Create a new directory named my-skill with a SKILL.md containing the required frontmatter and a concise description, then add any optional resources as needed.

Frequently Asked Questions about writing-skill-md

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

FAQPage Schema
How do I validate agent skill frontmatter for compliance?

Skill structure compliance requires the root SKILL.md to define a name and description in the frontmatter. The skill name must match its parent directory, and the body guidelines must be validated to ensure proper discovery and activation.

What is the expected directory layout for authoring agent skills?

The expected directory layout for agent skills is a root folder named skill-name containing a SKILL.md file. You can also include optional folders like scripts/, references/, and assets/ to provide additional resources for the skill unit.

How do I audit an existing agent skill for SKILL.md format adherence?

To audit an existing agent skill for SKILL.md format adherence, verify the required frontmatter fields are present, validate the body guidelines, and identify optional resources. This compliance audit ensures the skill is fully activatable.

Do I need optional resource folders to create a valid agent skill?

You do not need optional resource folders to create a valid agent skill. A valid skill only requires a directory containing a SKILL.md file with the required name and description frontmatter, while folders like scripts and assets are entirely optional.

Why does my agent skill fail validation when the name does not match the directory?

Agent skill validation fails when the name does not match the directory because the skill-authoring spec requires the frontmatter name field to exactly match the parent directory name to ensure consistent discovery and activation.