skills.rest
Clay-HHK
Clay-HHKCOMMUNITY
Explore all skills by this author →
GitHub

Skill Development

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

2|Updated Apr 12, 2026
Search Tags:#documentation#plugin#skill-development#create#claude-code#references#progressive-disclosure
One-click install
npx skills add https://github.com/Clay-HHK/claude-config --skill skill-development-clay-hhk
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: Skill Development
Source: https://github.com/Clay-HHK/claude-config/tree/main/skills/skill-development
Command: npx skills add https://github.com/Clay-HHK/claude-config --skill skill-development-clay-hhk

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Provide clear, reusable guidance to create, structure, and maintain Claude Code plugin skills, reducing duplicated effort, inconsistent formats, and bloated documentation that harms discoverability and context efficiency.

Core Features & Use Cases

  • Skill authoring guidance: Define required SKILL.md frontmatter, trigger phrases, and imperative writing style to ensure reliable discovery and usage.
  • Progressive disclosure: Recommend what belongs in SKILL.md versus references/examples/scripts to keep the skill lean and context-efficient.
  • Resource organization & validation: Outline directory structure, validation checklist, and testing steps for plugin-integrated skills.
  • Use Case: Add a new "pdf-editor" skill to a plugin by drafting SKILL.md with trigger phrases, moving detailed patterns into references/, and adding utility scripts to scripts/ for deterministic tasks.

Quick Start

Draft SKILL.md with YAML frontmatter including name and description, write the body in imperative form, and place detailed materials in references/ to enable progressive disclosure.

Frequently Asked Questions about Skill Development

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a Claude Code plugin skill with the correct SKILL.md format?▼

To create a Claude Code plugin skill, draft a SKILL.md file with YAML frontmatter including name and description, write the body using an imperative style with specific trigger phrases, and place detailed materials in a references directory.

What is progressive disclosure in Claude Code skill development?▼

Progressive disclosure in skill development separates core trigger phrases and instructions in SKILL.md from detailed patterns, examples, and utility scripts stored in references or scripts directories to keep the plugin lean and context-efficient.

How do I structure references and scripts for a Claude Code plugin?▼

Structure references and scripts by moving detailed implementation patterns into a references directory and adding deterministic utility scripts to a scripts directory, ensuring the main SKILL.md stays focused on triggers and high-level guidance.

What should be included in the YAML frontmatter of a SKILL.md file?▼

The YAML frontmatter of a SKILL.md file must include the skill name and description, ensuring reliable discovery and usage within the Claude Code plugin environment.

Can I use existing documentation patterns when adding a new skill to a plugin?▼

Yes, you can apply existing documentation patterns by reusing the structured guidance for SKILL.md authoring, organizing resource directories, and following the validation checklist to maintain consistent formats and reduce duplicated effort.

Why does my Claude Code skill fail to trigger reliably during plugin usage?▼

A Claude Code skill may fail to trigger if the SKILL.md lacks specific trigger phrases, is not written in an imperative style, or contains bloated documentation that harms discoverability and context efficiency.

Related Skills

Explore More Software Engineering Skills→
gmickelgmickel
674

flow-next-ralph-init

Scaffold a repo-local Ralph harness under scripts/ralph/ for Flow-Next projects.

Community
Basic
JaimeJunrJaimeJunr
2

run-tests

Execute unit and integration tests, analyze failures, and re-run to verify corrections.

Community
Advanced
archibatearchibate
6

skill-development

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

Community
Intermediate
murphyjosephmurphyjoseph

skill-development

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

Community
Advanced