skill-development

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

Updated Mar 1, 2026

Search Tags:#skill-development #claude-code #references #progressive-disclosure #yaml-frontmatter #plugin-skills #imperative-writing

Ready to run

npx skills add https://github.com/murphyjoseph/dojo-kit --skill skill-development-murphyjoseph

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: skill-development
Source: https://github.com/murphyjoseph/dojo-kit/tree/main/.agents/skills/skill-development
Command: npx skills add https://github.com/murphyjoseph/dojo-kit --skill skill-development-murphyjoseph

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps teams design, document, and maintain high-quality Claude Code plugin skills. It clarifies how to structure SKILL.md, references, and optional resources, ensuring progressive disclosure and consistent skill creation.

Core Features & Use Cases

Provide a clear blueprint for skill creation, including SKILL.md frontmatter and body, and optional bundled resources (scripts, references, assets).
Define a reusable process for planning, implementing, and validating skills, including validation checks and plugin-distribution steps.
Offer best-practice guidance for writing style (imperative/infinitive), trigger phrases, and lean SKILL.md with content moved to references/.
Enable progressive disclosure workflows for Claude Code plugin skills, reducing context load and enabling on-demand references.

Quick Start

Outline the skill purpose, initialize the skill structure with SKILL.md frontmatter and lean body, then place extended content in references/ and examples/.

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?▼

Structure Claude Code plugin skills by writing a lean SKILL.md with YAML frontmatter and imperative body text, then move extended content into references/ and examples/ directories to enable progressive disclosure and reduce context load.

What is the best way to write trigger phrases for Claude Code skills?▼

Write trigger phrases for Claude Code skills using clear, specific terms that match user intents, placing them in the YAML frontmatter to ensure the skill activates correctly when needed.

Do I need YAML frontmatter in every SKILL.md file?▼

Yes, YAML frontmatter is required in every SKILL.md file to define metadata, trigger phrases, and skill organization, ensuring Claude Code can properly index and activate the skill.

How do I organize references and assets in a Claude Code plugin?▼

Organize references and assets in a Claude Code plugin by placing extended documentation in references/, example files in examples/, and scripts in a scripts/ directory, keeping the root SKILL.md lean.

Why should I use imperative writing style in SKILL.md?▼

Use imperative writing style in SKILL.md to provide clear, direct instructions that Claude Code can follow precisely, ensuring consistent skill execution and reducing ambiguity in processing logic.

Can I bundle scripts and assets directly within a Claude Code plugin skill?▼

Yes, you can bundle scripts, references, and assets within a Claude Code plugin skill by organizing them in plugin-compatible directory structures, keeping SKILL.md lean while supporting on-demand resource loading.