Skill Development

Create and organize Claude Code plugin skills with SKILL.md frontmatter and progressive disclosure.

1|Updated Mar 29, 2026
One-click install
npx skills add https://github.com/dmedina-dev/dev-forge --skill skill-development-dmedina-dev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Skill Development
Source: https://github.com/dmedina-dev/dev-forge/tree/main/plugins/forge-plugin-dev/skills/skill-development
Command: npx skills add https://github.com/dmedina-dev/dev-forge --skill skill-development-dmedina-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The Skill Development skill helps plugin authors create and organize Claude Code plugin skills by providing a structured template, best-practice guidance, and clear resource layout to ensure progressive disclosure and maintainable documentation.

Core Features & Use Cases

  • Provides a standardized SKILL.md frontmatter template with required fields and imperative guidance
  • Defines a scalable structure using optional references/scripts/assets folders to store reusable resources
  • Guides packaging, validation, and iterative improvement workflows for plugin skills

Quick Start

Create a new skill scaffold in your plugin's skills/ directory and begin populating SKILL.md and resource folders.

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 progressive disclosure?

To structure plugin skills, keep the SKILL.md body lean with imperative guidance and store detailed resources in optional references, scripts, and assets folders. This progressive-disclosure design ensures maintainable plugin documentation.

What should I include in SKILL.md frontmatter for Claude Code plugins?

SKILL.md frontmatter should include required metadata fields defined by a standardized template with imperative guidance. This ensures proper plugin skill packaging, validation, and discovery within the Claude Code ecosystem.

How do I create a new skill scaffold in a Claude Code plugin?

Create a new skill scaffold in your plugin's skills/ directory, then populate the SKILL.md file and optional references, scripts, and assets folders. This scaffolding process establishes a scalable structure for reusable plugin resources.

When do I need references versus scripts versus assets folders in plugin skills?

Use references folders for detailed documentation, scripts for executable logic, and assets for static files. This scalable structure supports progressive disclosure by externalizing resources from the lean SKILL.md body.

What is the best way to organize reusable resources across multiple Claude Code plugin skills?

Organize reusable resources using a scalable folder structure with optional references, scripts, and assets directories. Combined with a standardized SKILL.md template, this approach ensures maintainability and progressive disclosure across multiple plugin skills.

Does Claude Code plugin skill development require any external dependencies?

No external dependencies are required for Claude Code plugin skill development. The process focuses on writing SKILL.md frontmatter, structuring references folders, and ensuring progressive-disclosure design using standardized templates and best-practice guidance.