create-skill

Create structured SKILL.md metadata blueprints with required frontmatter and concise bodies.

Updated Mar 4, 2026

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

Ready to run

npx skills add https://github.com/jonasalessi/playground-mcp-skills --skill create-skill-jonasalessi

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: create-skill
Source: https://github.com/jonasalessi/playground-mcp-skills/tree/main/.agents/skills/create-skill
Command: npx skills add https://github.com/jonasalessi/playground-mcp-skills --skill create-skill-jonasalessi

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill provides a disciplined approach for creating, standardizing, and maintaining high-quality agent skills by enforcing a consistent structure, frontmatter, and reference architecture that accelerates discovery and reliable execution.

Core Features & Use Cases

Provides a clear scaffold for new skills (frontmatter + body)
Enables progressive disclosure by separating long guidance into references
Supports consistent maintenance and collaboration across teams

Quick Start

Create a new skill directory with SKILL.md that includes the required YAML frontmatter (name and description) and a concise instructional body that fits within the recommended length.

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 with consistent metadata structure?▼

To create an agent skill, use a structured metadata blueprint by setting up a SKILL.md file with required YAML frontmatter (name and description) and a concise instructional body for reliable execution and discovery.

What is progressive disclosure in skill documentation?▼

Progressive disclosure is a documentation best-practice that separates long instructional guidance into optional reference files, keeping the core SKILL.md body concise while linking detailed resources for deterministic task execution.

How do I structure YAML frontmatter for a new skill?▼

Structure YAML frontmatter for a new skill by including the required 'name' and 'description' fields at the top of the SKILL.md file, ensuring consistent discovery and on-load guidance for agents.

When should I use optional resources like scripts and references in a skill?▼

Use optional resources like scripts, references, and assets only when needed for deterministic task execution, ensuring you enforce correctness of their references within the skill's architecture.

What is the best way to standardize agent skill creation across teams?▼

Standardize agent skill creation across teams by applying a disciplined scaffold using SKILL.md, enforcing consistent frontmatter, and utilizing progressive disclosure to separate long guidance into references for reliable maintenance.

Does skill documentation require long instructional bodies for execution?▼

Skill documentation does not require long instructional bodies; it enforces a concise body within the recommended length, applying progressive disclosure to separate extended guidance into optional reference files.