skill-design-guide

Design and validate Claude skills with structured folder layouts and YAML frontmatter.

10|2|Updated Feb 14, 2026

Search Tags:#testing #mcp #distribution #frontmatter #yaml-frontmatter #skill-design #workflow-patterns

Ready to run

npx skills add https://github.com/metaskills/skill-design-guide --skill skill-design-guide-metaskills

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: skill-design-guide
Source: https://github.com/metaskills/skill-design-guide/tree/main
Command: npx skills add https://github.com/metaskills/skill-design-guide --skill skill-design-guide-metaskills

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

The Skill Design Guide provides a structured, interactive framework to design, build, test, and distribute Claude skills, ensuring consistent structure, frontmatter, and progressive disclosure across tools and MCP integrations.

Core Features & Use Cases

Clear skill structure: SKILL.md at root, optional scripts/references/assets directories.
Progressive disclosure: YAML frontmatter, SKILL.md body, then linked resources.
Design patterns reference: guidance on Sequential, Multi-MCP, Iterative, Context-Aware, and Domain-Specific patterns.
Step-by-step workflow: from use-case definition to distribution and debugging.
Testing, iteration, and distribution guidance to deploy skills safely.

Quick Start

Follow the interactive steps to design, structure, and validate a new skill starting from use cases to distribution.

Frequently Asked Questions about skill-design-guide

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

FAQPage Schema

How do I structure YAML frontmatter for Claude skills?▼

YAML frontmatter for Claude skills enforces naming discipline and progressive disclosure, placing metadata at the root SKILL.md before linked resources. This structure ensures reliable parsing across MCP integrations.

What is the best way to design a skill folder layout for MCP integrations?▼

The best folder layout places SKILL.md at the root with optional scripts, references, and assets directories. This structure applies progressive disclosure to manage context across Multi-MCP and Context-Aware workflow patterns.

How do I test and validate a Claude skill before distribution?▼

Testing and validating a Claude skill involves following a structured workflow from use-case definition through debugging. The design guide provides testing and iteration steps to ensure safe deployment and distribution.

What workflow patterns are supported for building Claude skills?▼

Supported workflow patterns include Sequential, Multi-MCP, Iterative, Context-Aware, and Domain-Specific designs. These patterns guide how skills interact with tools and manage progressive disclosure across different use cases.

Do I need any dependencies to create and distribute a Claude skill?▼

No dependencies are required to design and validate a Claude skill. The guide provides a self-contained framework covering structure, frontmatter, testing, and distribution guidance without external packages.

When should I use progressive disclosure in skill design?▼

Progressive disclosure should be used when skills require structured context management across MCP integrations. It layers information from YAML frontmatter to SKILL.md body to linked resources, preventing context overload.