skill-development

Create Claude Code skills with SKILL.md frontmatter and bundled resources.

15|4|Updated Apr 18, 2026

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

Ready to run

npx skills add https://github.com/damionrashford/media-os --skill skill-development-damionrashford

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: skill-development
Source: https://github.com/damionrashford/media-os/tree/main/.claude/plugins/plugin-dev/skills/skill-development
Command: npx skills add https://github.com/damionrashford/media-os --skill skill-development-damionrashford

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill Development guide helps plugin authors structure Claude Code skills, define the required SKILL.md frontmatter, and organize optional resources (scripts, references, assets) for progressive disclosure and reliable loading.

Core Features & Use Cases

Define a standardized skill anatomy with a mandatory SKILL.md and optional bundled resources.
Outline a practical workflow for creating, validating, packaging, and iterating skills within Claude Code plugins.
Provide best practices for lean SKILL.md, centralized references, and reusable assets to speed development.

Quick Start

Prepare a new skill folder named after the skill, include a SKILL.md with name and description, and add optional references, examples, or scripts as needed; reference references for advanced guidance.

Frequently Asked Questions about skill-development

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

FAQPage Schema

How do I structure a Claude Code plugin skill for reliable loading?▼

To structure a Claude Code plugin skill, create a folder named after the skill and include a mandatory SKILL.md file with required frontmatter metadata, then add optional bundled resources like scripts, references, and assets as needed.

What is progressive disclosure in Claude Code skills?▼

Progressive disclosure in Claude Code skills is a best practice that keeps the core SKILL.md lean by centralizing advanced guidance and references in optional bundled files, exposing detailed information to Claude only when needed.

What frontmatter metadata is required in a SKILL.md file?▼

A SKILL.md file requires frontmatter metadata that includes the skill name and description to define the skill's identity and ensure it is correctly recognized and loaded within the Claude Code plugin ecosystem.

How do I bundle scripts and references when creating Claude Code skills?▼

You bundle scripts and references by placing them alongside the SKILL.md file in the skill folder, organizing these optional resources to support progressive disclosure and enable reusable assets for plugin development.

What is the best way to validate and iterate skills within the Claude Code plugin ecosystem?▼

The best way to validate and iterate skills is to follow a practical workflow of creating the skill folder, defining the SKILL.md frontmatter, packaging bundled resources, and testing the progressive disclosure behavior within Claude Code plugins.

Do I need to include scripts and references to create a valid Claude Code skill?▼

No, scripts and references are optional; a valid Claude Code skill only requires a SKILL.md file with proper frontmatter metadata, but bundling these resources speeds development and enables advanced progressive disclosure.