create-skill

Create new agent skills with required frontmatter and kebab-case naming.

Updated Feb 2, 2026

Search Tags:#validation #structure #skill #kebab-case #create #frontmatter #agentskills

Ready to run

npx skills add https://github.com/newmoon-org/agent-rules --skill create-skill-newmoon-org

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: create-skill
Source: https://github.com/newmoon-org/agent-rules/tree/main/skills/create-skill
Command: npx skills add https://github.com/newmoon-org/agent-rules --skill create-skill-newmoon-org

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a clear, systematic process for creating new agent skills that follow the agentskills.io specification, including naming conventions, frontmatter validation, and folder structure.

Core Features & Use Cases

Structured skill creation: guidance on naming, directory layout, and required frontmatter.
Validation guidance: how to verify SKILL.md frontmatter fields and optional metadata.
Resource organization: how to organize optional scripts/, references/, and assets/ for future loading.

Quick Start

Create a new directory under skills/ named after your skill (in kebab-case) and add a SKILL.md with required frontmatter to begin.

Frequently Asked Questions about create-skill

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

FAQPage Schema

How do I create an agent skill that follows the agentskills.io specification?▼

To create an agent skill, scaffold a new directory in kebab-case and add a SKILL.md file with required frontmatter fields like name and description to ensure proper discovery and loading.

What frontmatter fields are required in a SKILL.md file?▼

Required frontmatter fields in a SKILL.md file are name and description, while optional fields are supported to guide progressive disclosure of content for agent skill discovery.

How should I organize scripts, references, and assets when building an agent skill?▼

Organize supporting resources by placing them into optional scripts, references, and assets directories to structure them for future loading and proper agent skill resource management.

Why does my agent skill fail validation during creation?▼

Agent skill validation fails when the SKILL.md frontmatter is missing required fields or the directory name is not formatted in kebab-case according to the agentskills.io specification.

What is the best way to name an agent skill directory?▼

The best way to name an agent skill directory is using kebab-case formatting, which enforces lowercase letters and hyphens to ensure compatibility with the agentskills.io specification.