skills.rest
jasonsie
jasonsieCOMMUNITY
Explore all skills by this author →
GitHub

Skill Development

Define and validate Claude Code plugin skills with SKILL.md frontmatter and progressive disclosure.

Updated Aug 23, 2026
Search Tags:#documentation#validation#best-practices#skill-development#claude-code#progressive-disclosure#plugin-architecture
One-click install
npx skills add https://github.com/jasonsie/prompt-dev --skill skill-development-jasonsie
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: Skill Development
Source: https://github.com/jasonsie/prompt-dev/tree/main/skills/skill-development
Command: npx skills add https://github.com/jasonsie/prompt-dev --skill skill-development-jasonsie

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill provides a structured blueprint and best-practices for creating, validating, and maintaining Claude Code plugin skills. It defines a lean core SKILL.md, progressive disclosure, and tooling guidance for consistent quality across plugins.

Core Features & Use Cases

  • Structured skill templates with SKILL.md frontmatter, lean core, and optional resources (references, examples, scripts).
  • Progressive disclosure design ensuring core content loads quickly and detailed docs load as needed.
  • Validation and packaging guidance with utilities to ensure quality before deployment.

Quick Start

Follow the Skill Creation Process to structure and validate a new Claude Code plugin skill.

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, use a canonical structure with a lean core SKILL.md containing frontmatter, and move detailed documentation to references/, examples/, and scripts/ directories to ensure reliable loading and deployment.

What is progressive disclosure in skill development?▼

Progressive disclosure in skill development is a design pattern ensuring the lean core SKILL.md content loads quickly, while detailed documentation, examples, and scripts load dynamically as needed from separate reference directories.

How do I validate Claude Code plugin skills before deployment?▼

You validate Claude Code plugin skills by running automated validation utilities that verify triggers, directory structure, naming conventions, and tooling to ensure quality and proper deployment readiness.

What should be included in SKILL.md frontmatter for plugin architecture?▼

SKILL.md frontmatter for plugin architecture should include proper naming, categorization, and documentation metadata to ensure the skill is correctly identified, validated, and reliably loaded by the Claude Code environment.

Why does my Claude Code skill load slowly or fail validation?▼

Claude Code skills load slowly or fail validation when the core SKILL.md is too heavy or improperly structured; apply progressive disclosure by moving detailed material to references and scripts directories, then run automated validation to fix triggers and structure.

Related Skills

Explore More Software Engineering Skills→
shopwareLabsshopwareLabs
41

setting-up

Guide developers through MCP tooling setup for Shopware plugin development.

Official
Intermediate
archibatearchibate
6

skill-development

Guide creation and organization of Claude Code plugin skills with SKILL.md.

Community
Intermediate
manifoldlogicmanifoldlogic

skill-md-structure

Analyze SKILL.md documentation patterns for Claude Code plugins.

Official
Intermediate
joncranglejoncrangle
8

skill-development

Create Claude Code plugin skills with SKILL.md structure and validation.

Community
Intermediate