skill-development

Create, structure, and validate Claude Code Skill units with SKILL.md frontmatter.

Updated Mar 24, 2026
One-click install
npx skills add https://github.com/Airmomo/skills --skill skill-development-airmomo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-development
Source: https://github.com/Airmomo/skills/tree/main/skill-development
Command: npx skills add https://github.com/Airmomo/skills --skill skill-development-airmomo

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Creates a standard, reusable blueprint for building high-quality Skills for Claude Code plugins, ensuring consistent structure, frontmatter validation, progressive disclosure, and clear guidance on where to place references, scripts, and assets.

Core Features & Use Cases

  • Define a standard SKILL.md anatomy with required frontmatter (name, description) and a detailed body.
  • Enforce progressive disclosure by moving in-depth content to references/ while keeping SKILL.md lean.
  • Provide a cohesive skill creation process, validation steps, and plugin-specific guidance for developers.

Quick Start

Draft a lean SKILL.md with frontmatter, then populate references/ for detailed topics and scripts/examples 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 structure a Claude Code plugin skill with progressive disclosure?

Structure a Claude Code plugin skill by drafting a lean SKILL.md with required frontmatter such as name and description, then move in-depth content into a references/ directory to enforce progressive disclosure and keep the skill body lean.

What frontmatter fields are required for a Claude Code SKILL.md file?

Required frontmatter fields for a Claude Code SKILL.md file include name and description, ensuring clear skill loading and consistent metadata validation across plugin units.

Where should I place scripts and assets when creating a Claude Code plugin?

Place scripts and assets in dedicated directories alongside your references when creating a Claude Code plugin, ensuring scalable resource organization and consistent skill loading within the plugin architecture.

What is progressive disclosure in Claude Code skill development?

Progressive disclosure in Claude Code skill development keeps the SKILL.md body lean by moving detailed topics to a references/ directory, ensuring the plugin loads only necessary context initially.

How do I validate Claude Code plugin skills before deployment?

Validate Claude Code plugin skills by checking frontmatter fields for required name and description entries, verifying the SKILL.md body remains lean, and confirming all references and scripts are correctly organized.

Can I use best practices to organize Claude Code plugin references and scripts?

Yes, apply best practices to organize Claude Code plugin references and scripts by separating in-depth content into references/ and maintaining a cohesive resource structure for scalable skill loading.