skills.rest
pkuppens
pkuppensCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

skill-creation

Organizes and validates AI skill directories with standardized SKILL.md frontmatter and layout.

Updated Jan 5, 2025
Search Tags:#architecture#documentation#yaml#best-practices#skill#frontmatter#skill-creation
One-click install
npx skills add https://github.com/pkuppens/pkuppens --skill skill-creation-pkuppens
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-creation
Source: https://github.com/pkuppens/pkuppens/tree/main/skills/_meta/skill-creation
Command: npx skills add https://github.com/pkuppens/pkuppens --skill skill-creation-pkuppens

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Guides creation of new AI coding skills for Cursor, Claude, and Codex. Use when creating, writing, or authoring a new skill, or when asking about skill structure, SKILL.md format, or best practices. Enforces single responsibility, one-liner, progressive disclosure, and Claude skill structure.

Core Features & Use Cases

  • Provides a standardized structure for skill directories, including SKILL.md frontmatter and optional reference.md and examples.md.
  • Demonstrates how to write a clear name and description that support discovery and proper categorization.
  • Offers guidance on progressive disclosure: metadata, body, and additional resources loaded as needed.

Quick Start

Create a new skill directory with SKILL.md containing a YAML frontmatter and a concise body that follows the standard structure.

Frequently Asked Questions about skill-creation

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

FAQPage Schema
What is the standard SKILL.md frontmatter format for creating AI coding skills?▼

The standard SKILL.md frontmatter is a YAML block defining a skill's name, description, and minimal references, ensuring compliance with single responsibility and Claude skill structure.

How do I structure a new AI skill directory for Cursor or Claude?▼

To structure an AI skill directory, create a root folder containing a SKILL.md file alongside optional reference.md and examples.md files to support progressive disclosure and detailed documentation.

What are the best practices for writing AI skill descriptions?▼

Best practices for AI skill descriptions involve writing concise one-liners that enforce single responsibility, ensuring the description directly supports discovery and proper categorization.

When do I need to use progressive disclosure in skill creation?▼

Progressive disclosure is needed when organizing skill content, allowing metadata and body details to load first while keeping additional resources in optional reference and examples directories for on-demand loading.

Does this skill creation guide work with Codex as well as Cursor?▼

Yes, this skill creation guide works with Codex, Cursor, and Claude, providing a standardized structure and validation rules applicable across multiple AI coding platforms.

Why does my AI skill need to follow single responsibility principles?▼

AI skills need to follow single responsibility principles to maintain a clear, focused structure, preventing feature bloat and ensuring the skill performs one specific core task effectively.

Related Skills

Explore More Software Engineering Skills→
dbowm91dbowm91

skills

Load and activate markdown-defined agent skills from project directories.

Community
Intermediate
SkillsCatalogSkillsCatalog
1

skill-validator

Validate agent skill directories against the SKILL.md specification.

Official
Advanced
erclxerclx
2

create-skill

Generate compliant skill directories and SKILL.md files with validated frontmatter.

Community
Intermediate
pantheon-orgpantheon-org
1

nx-generators

Automate Nx generator creation with Nx DevKit and TypeScript tooling.

Official
Intermediate