create-skill

Create Skill units with standardized YAML frontmatter and optional resources.

Updated Dec 12, 2025

Search Tags:#documentation #best-practices #frontmatter #progressive-disclosure #skill-structure #skill-authoring

Ready to run

npx skills add https://github.com/SatanaCSharp/animemoria --skill create-skill-satanacsharp

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: create-skill
Source: https://github.com/SatanaCSharp/animemoria/tree/main/.claude/skills/create-skill
Command: npx skills add https://github.com/SatanaCSharp/animemoria --skill create-skill-satanacsharp

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Creating consistent, discoverable Skill units is challenging without a standardized template. This guide provides the structure, naming conventions, and reference patterns that help teams produce maintainable, reusable Skills.

Core Features & Use Cases

Standard YAML frontmatter with mandatory name and description to enable reliable discovery.
Clear guidelines for optional resources (scripts/, references/, assets/) and how to organize them for progressive disclosure.
Rules for keeping SKILL.md under 200 lines and using references to host longer content.
Templates and best-practices guidance to improve consistency, evaluation, and safe usage.

Quick Start

Create a new skill by adding a SKILL.md with YAML frontmatter containing name and description in the skill's root directory, and optionally add a references/ folder for extended details.

Frequently Asked Questions about create-skill

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

FAQPage Schema

How do I structure agent skills for discoverability and reuse?▼

To structure agent skills for discoverability, use a root SKILL.md file with standardized YAML frontmatter containing mandatory name and description fields. This enables reliable discovery and consistent activation across teams.

What is progressive disclosure in skill authoring?▼

Progressive disclosure in skill authoring keeps the main SKILL.md under 200 lines while storing extended details in a references/ folder. This allows fast activation by loading only necessary content on demand.

How do I create a new skill with YAML frontmatter?▼

Create a new skill by adding a SKILL.md file in the skill's root directory with YAML frontmatter specifying the name and description. Optionally add a references/ folder to host longer content and resources.

Does skill authoring require specific dependencies or scripts?▼

Skill authoring does not require specific dependencies, as scripts and assets are optional resources. You can organize them in dedicated directories to support execution, but only the SKILL.md file with frontmatter is mandatory.

What is the best way to organize skill resources like scripts and references?▼

The best way to organize skill resources is using separate directories for optional components like scripts/, references/, and assets/. This structure maintains a concise SKILL.md while supporting progressive disclosure for extended details.

Why should I keep SKILL.md under 200 lines?▼

Keeping SKILL.md under 200 lines ensures fast activation and maintainability by preventing context overload. Longer content should be moved to the references/ folder to enforce progressive disclosure and reliable skill deployment.