skill-development

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

Updated Mar 27, 2026
One-click install
npx skills add https://github.com/onelee85/my-skills --skill skill-development-onelee85
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-development
Source: https://github.com/onelee85/my-skills/tree/main/claude-plugins-official/plugins/plugin-dev/skills/skill-development
Command: npx skills add https://github.com/onelee85/my-skills --skill skill-development-onelee85

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The skill provides a structured approach for creating effective Claude Code skills, aligning YAML frontmatter, content organization, and reusable resources to enable consistent, scalable guidance across plugin deployments.

Core Features & Use Cases

  • Standardized frontmatter with a precise name and description to enable reliable discovery and triggering.
  • Progressive disclosure design guiding Claude to load core content first and fetch references, examples, and assets as needed.
  • Clear resource organization detailing where to place scripts, references, and assets for reusable, deterministic workflows.
  • Step-by-step workflow coverage from understanding use cases through validation, testing, and iteration to improve skills over time.

Quick Start

Create a new plugin skill by adding SKILL.md with proper YAML frontmatter (name and description), and prepare optional directories for references, examples, and scripts 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 build a Claude Code skill from scratch?

To build a Claude Code skill, create a SKILL.md file with proper YAML frontmatter for metadata, then structure content using progressive disclosure to load core guidance first and fetch references or scripts as needed.

What is progressive disclosure in Claude Code skills?

Progressive disclosure is a design pattern that guides Claude to load core SKILL.md content first, fetching external references, examples, and assets dynamically only when deeper guidance is required.

How do I format YAML frontmatter for plugin skills?

YAML frontmatter for plugin skills requires a precise name and description to enable reliable discovery and triggering, formatted at the top of the SKILL.md file before the lean body content.

Where should I put scripts and references when creating Claude Code plugins?

Scripts and references should be organized in optional directories alongside SKILL.md, enabling reusable and deterministic workflows by separating assets from the core lean skill body.

Does progressive disclosure work with large SKILL.md files?

Progressive disclosure is designed for large skills, keeping the SKILL.md body lean while storing detailed examples and scripts in separate reference directories fetched only when needed.

How do I validate and test Claude Code skills during development?

You validate and test Claude Code skills by following the step-by-step workflow coverage, iterating through use case understanding and validation to improve skill reliability over time.