skills.rest
murphyjoseph
murphyjosephCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

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
One-click install
npx skills add https://github.com/murphyjoseph/dojo-kit --skill skill-development-murphyjoseph
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
hamzaPixlhamzaPixl
2

plugin-settings

Parse, validate, create, and update plugin settings in `.claude/*.local.md` files.

Community
Intermediate
VanLengsVanLengs
1

plugin-validator

Validate Claude Code plugin directories for structure, manifest conformance, and dependencies.

Community
Advanced
Invictusprime7Invictusprime7
1

Skill Development

Standardize Claude Code skill structure with YAML frontmatter and SKILL.md.

Community
Advanced
nerinanarinenerinanarine

skill-development

Guide creation of Claude Code plugin skills with progressive disclosure.

Community
Advanced