skills.rest
jonasalessi
jonasalessiCOMMUNITY
Explore all skills by this author →
GitHub

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
One-click install
npx skills add https://github.com/jonasalessi/playground-mcp-skills --skill create-skill-jonasalessi
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Content & Communication Skills→
vythanhtravythanhtra
8

create-skill

Generate SKILL.md files with standards-compliant YAML frontmatter and directory structure.

Community
Intermediate
kehwarkehwar

skill-creator

Scaffold and validate Skill units with SKILL.md frontmatter and resource scaffolds.

Community
Intermediate
nicholasgriffintnnicholasgriffintn
2

add-skill

Create and validate SKILL.md files with YAML frontmatter for OpenCode or Claude.

Community
Basic
PytaichukBohdanPytaichukBohdan

creating-new-skills

Create new Claude Code Agent Skills with structured SKILL.md files.

Community
Intermediate