skill-development

Standardize Claude Code plugin skills with frontmatter-driven SKILL.md packaging.

15|6|Updated May 7, 2026

Search Tags:#templates #skill-development #claude-code #progressive-disclosure #plugin-skills #skill-frontmatter

Ready to run

npx skills add https://github.com/MinhThang1009/dotclaude --skill skill-development-minhthang1009

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: skill-development
Source: https://github.com/MinhThang1009/dotclaude/tree/main/plugins/plugin-dev/skills/skill-development
Command: npx skills add https://github.com/MinhThang1009/dotclaude --skill skill-development-minhthang1009

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Structured skill development metadata accelerates Claude Code plugin adoption by providing a clear blueprint for creating, organizing, and distributing self-contained Skill Units. It ensures consistency across plugins and enables progressive disclosure of details.

Core Features & Use Cases

Provides a standard SKILL.md frontmatter with mandatory fields (name and description) and a well-structured Markdown body that guides how to use the skill.
Defines optional bundles (scripts/, references/, assets/) to store reusable utilities, documentation, and output assets for skills.
Enforces progressive disclosure: core guidance in SKILL.md while detailed references live in references/ and full examples in examples/.

Quick Start

Create a new skill folder under your plugin's skills directory, add a SKILL.md with proper frontmatter, and populate optional references, scripts, and assets as needed.

Frequently Asked Questions about skill-development

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

FAQPage Schema

How do I create a Claude Code plugin skill with frontmatter?▼

To create a Claude Code plugin skill, add a SKILL.md file with mandatory name and description frontmatter fields in your plugin's skills directory, then populate optional bundles like scripts and references as needed.

What is progressive disclosure in skill development?▼

Progressive disclosure in skill development places core guidance directly in SKILL.md while moving deeper details into references and full examples into examples directories to enable predictable resource organization.

How do I structure a Claude Code skill for auto-discovery?▼

Structure a Claude Code skill for auto-discovery by using a consistent frontmatter-driven format in SKILL.md and organizing reusable utilities into optional bundles like scripts, references, and assets.

What files do I need to package a self-contained skill unit?▼

Packaging a self-contained skill unit requires a SKILL.md file with proper frontmatter, and optionally includes a references directory for documentation, scripts for utilities, and assets for output files.

Does Claude Code validate plugin skills automatically?▼

Yes, Claude Code can auto-discover, validate, and load plugin skills through a predictable folder structure and resource organization specified by the frontmatter-driven SKILL.md format.

When should I separate skill guidance from detailed references?▼

You should separate skill guidance from detailed references when core instructions fit in SKILL.md but deeper documentation and full examples need their own directories to maintain progressive disclosure and reduce clutter.