skills.rest
metaskills
metaskillsCOMMUNITY
Explore all skills by this author →
GitHub

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

Related Skills

Explore More Software Engineering Skills→
StepfenShawnStepfenShawn
100

example

Structure a Skill unit using the SKILL.md format with frontmatter parsing and optional resources wiring.

Community
Basic
p-iknowp-iknow
1

meta-skill

Create, validate, and package AI agent skills with SKILL.md metadata.

Community
Intermediate
Marwan78888Marwan78888
16

writing-skills

Document and validate Skills using a strict TDD workflow.

Community
Advanced
jasonjgardnerjasonjgardner
340

skill-creator

Create standardized Codex Skill units with templates, scaffolding, and .skill packaging.

Community
Advanced