skills.rest
kurokeita
kurokeitaCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

Skill Development

Design Claude Code plugin skills with structured frontmatter and lean SKILL.md bodies.

1|Updated Jan 17, 2026
Search Tags:#templates#documentation#Claude Code#plugin development#progressive disclosure#skill-creation
One-click install
npx skills add https://github.com/kurokeita/ai-agent --skill skill-development-kurokeita
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: Skill Development
Source: https://github.com/kurokeita/ai-agent/tree/main/skills/skill-development
Command: npx skills add https://github.com/kurokeita/ai-agent --skill skill-development-kurokeita

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides a standardized blueprint for creating Claude Code plugin skills, enabling consistent metadata, lean SKILL.md bodies, and a structured discovery surface through references, examples, and scripts.

Core Features & Use Cases

  • Define SKILL.md with proper YAML frontmatter (name and description) and a concise, imperative body.
  • Organize support resources in references/, examples/, and scripts/ to enable progressive disclosure and on-demand loading.
  • Validate skill structure, enforce third-person description, and ensure triggers are explicit.
  • Use cases include creating new skills for plugins, updating existing skills, and documenting best practices for skill creation.

Quick Start

Create a new skill directory under skills/ with SKILL.md. Add optional directories references/, examples/, and scripts/ as needed. In SKILL.md, provide frontmatter with the exact name and a description that describes trigger phrases in third person. Keep the body lean and move detailed guidance into references/. Use examples/ for runnable illustrations and scripts/ for utilities when 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 for progressive disclosure?▼

Claude Code plugin skills use a lean SKILL.md with YAML frontmatter and separate detailed content into references/, examples/, and scripts/ directories to enable progressive disclosure and on-demand loading. This keeps the body concise while supporting deeper guidance.

What is progressive disclosure in Claude Code skill development?▼

Progressive disclosure in skill development is an organizational pattern where SKILL.md remains lean and high-level, while detailed guidance, runnable examples, and deterministic scripts are separated into references/, examples/, and scripts/ directories for on-demand loading.

How do I write the YAML frontmatter for a Claude Code skill?▼

YAML frontmatter for a Claude Code skill requires a name and a description written in the third person. The description must explicitly state trigger phrases so the skill activates correctly, ensuring clear metadata validation and consistent discovery.

Can I put detailed instructions directly in the SKILL.md body?▼

Detailed instructions should not go directly in the SKILL.md body. The body must remain lean and imperative, while comprehensive documentation and deterministic execution scripts are moved into references/ and scripts/ directories respectively.

Does Claude Code skill development require any external dependencies?▼

Claude Code skill development requires no external dependencies. It provides a standardized blueprint using only structured frontmatter validation, lean SKILL.md bodies, and organized references, examples, and scripts directories to support plugin creation.

Related Skills

Explore More Software Engineering Skills→
outfitter-devoutfitter-dev
28

claude-plugin-authoring

Automate creation of Claude Code plugins with metadata, commands, agents, hooks, and MCP configurations.

Official
Intermediate
dobrinz123dobrinz123

skill-development

Creates and structures Claude Code plugin skills with SKILL.md frontmatter and progressive disclosure.

Community
Intermediate
GongXLiangGongXLiang

skill-development

Create and package Claude Code plugin skills with SKILL.md frontmatter.

Community
Intermediate
aryanshrai03aryanshrai03

Default Markdown Generation Skill

Generate GitHub-Flavored Markdown READMEs with hero-first structure and standardized sections.

Community
Intermediate