skills.rest
angrybeagles
angrybeaglesCOMMUNITY
Explore all skills by this author →
GitHub

skill-development

Create Claude Code plugin skills with lean SKILL.md and organized references.

Updated Apr 13, 2026
Search Tags:#templates#skill-development#claude-code#frontmatter#references#progressive-disclosure#plugin-skills
One-click install
npx skills add https://github.com/angrybeagles/weather-dashboard --skill skill-development-angrybeagles
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-development
Source: https://github.com/angrybeagles/weather-dashboard/tree/main/.claude/plugins/marketplaces/claude-plugins-official/plugins/plugin-dev/skills/skill-development
Command: npx skills add https://github.com/angrybeagles/weather-dashboard --skill skill-development-angrybeagles

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides a structured, repeatable approach for creating Claude Code plugin skills, ensuring consistency across frontmatter, lean SKILL.md bodies, and well-organized bundled resources (references, examples, and scripts) to support progressive disclosure.

Core Features & Use Cases

  • Define a clear SKILL.md anatomy with required metadata (name, description, version) and a Markdown body.
  • Establish progressive disclosure by moving detailed content into references/, examples/, and scripts/ as needed.
  • Provide template structures for plugin skills, including skills/skill-name/{references,examples,scripts} and a lean SKILL.md.
  • Enforce writing style guidelines: imperative/infinitive form, third-person frontmatter description, and well-defined trigger phrases.
  • Support validation and testing workflows using the included references and sample examples to ensure discoverability.

Quick Start

Initialize a new skill structure with the recommended directories, draft SKILL.md with frontmatter and a lean body, and place detailed guidance into references/.

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 with progressive disclosure?▼

Structure a Claude Code plugin skill by drafting a lean SKILL.md with required frontmatter and moving detailed content into organized references, examples, and scripts directories to enable progressive disclosure.

What is progressive disclosure in Claude Code skill development?▼

Progressive disclosure in skill development is the practice of keeping SKILL.md lean while moving detailed guidance, examples, and scripts into separate bundled resource directories for Claude Code to access as needed.

What frontmatter is required for a Claude Code plugin skill?▼

Required frontmatter for a Claude Code plugin skill includes a name and description, with version recommended. The description must be written in third-person to ensure proper discoverability and validation.

How do I validate that my Claude Code skill follows writing style guidelines?▼

Validate your Claude Code skill by checking that the SKILL.md body uses imperative form, frontmatter descriptions are third-person, and trigger phrases are well-defined, using included references and sample examples to ensure discoverability.

Can I use existing templates to initialize a new Claude Code skill structure?▼

Yes, you can initialize a new skill structure using provided template structures that include recommended directories for references, examples, and scripts alongside a lean SKILL.md file for Claude Code plugin development.

Why does my Claude Code skill need a lean SKILL.md instead of including all instructions?▼

A lean SKILL.md is needed because Claude Code skill development enforces progressive disclosure, moving detailed content into references and examples to maintain structure, reduce clutter, and support efficient context retrieval.

Related Skills

Explore More Software Engineering Skills→
huyhung9630huyhung9630
1

omc-skill

Manage local Codex skills with list, add, edit, and validate commands.

Community
Intermediate
AradotsoAradotso

aracli

Automate Claude Code skill distribution and synchronization across teams using aracli CLI.

Official
Advanced
mamba-mentalmamba-mental

Skill Development

Create and refine Claude Code skills with SKILL.md structure and progressive disclosure.

Community
Intermediate
fabioc-alohafabioc-aloha
1

API Documentation Skill

Scaffold technical documentation projects with templates for API endpoints and guides.

Community
Intermediate