skill-spec

Validate SKILL.md frontmatter and structure for Claude Code plugin Skill Units.

Updated Jan 8, 2026
One-click install
npx skills add https://github.com/biwakonbu/cc-plugins --skill skill-spec
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-spec
Source: https://github.com/biwakonbu/cc-plugins/tree/main/plugins/plugin-generator/skills/skill-spec
Command: npx skills add https://github.com/biwakonbu/cc-plugins --skill skill-spec

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill clarifies the correct structure and frontmatter for Skill Units used in Claude Code plugins.

Core Features & Use Cases

  • Ensures the required frontmatter fields (name and description) are present.
  • Guides proper SKILL.md layout with the mandatory frontmatter, sections, and body content.
  • Assists developers in validating skill formatting during creation, updates, and audits.

Quick Start

Create a new skill directory skills/{skill-name}/SKILL.md with the required frontmatter and a concise body that implements the skill. For example, set name to kebab-case, provide a description that states when the skill should be used, and include an Instructions section with step-by-step guidance.

Frequently Asked Questions about skill-spec

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

FAQPage Schema
What is the correct SKILL.md frontmatter format for Claude Code plugins?

The correct SKILL.md frontmatter for Claude Code plugins requires a name field set to kebab-case and a description field stating when the skill should be used. This mandatory frontmatter ensures the plugin skill is properly structured and discoverable.

How do I structure a SKILL.md file for a Claude Code plugin?

To structure a SKILL.md file, create a skills/{skill-name}/ directory, add the mandatory frontmatter with name and description, and include an Instructions section with step-by-step guidance for the skill body content.

Do I need specific frontmatter fields when creating a Claude Code skill?

Yes, creating a Claude Code skill requires specific frontmatter fields: name and description. These fields must be present to validate skill formatting during creation, updates, and audits.

What's the best way to audit existing skills in a Claude Code plugin?

The best way to audit existing skills in a Claude Code plugin is to check that each SKILL.md file contains the required name and description frontmatter and follows the recommended layout and kebab-case naming conventions.

Why does my Claude Code skill description need to state when it should be used?

Your Claude Code skill description needs to state when it should be used to ensure proper skill activation. This best practice clarifies the skill's scope and triggers, making it reliable during plugin development and audits.