Skill Development

Standardize Claude Code plugin skill creation with templates and progressive disclosure patterns.

Updated Aug 22, 2025
One-click install
npx skills add https://github.com/cdub615/dotfiles --skill skill-development-cdub615
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Skill Development
Source: https://github.com/cdub615/dotfiles/tree/main/opencode/.config/opencode/skill/skill-development
Command: npx skills add https://github.com/cdub615/dotfiles --skill skill-development-cdub615

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a structured, repeatable approach to creating and refining Claude Code plugin skills, enabling teams to standardize workflows, templates, and best practices for plugin development.

Core Features & Use Cases

  • Establishes a formal Skill Development template for Claude Code plugins, including frontmatter guidelines, lean SKILL.md bodies, and clear references to scripts, references, and assets.
  • Guides teams through progressive disclosure, ensuring core concepts load quickly while detailed content resides in references for on-demand access.
  • Supports rapid iteration and collaboration by providing reusable patterns, checklists, and starter content that reduces cognitive load during skill creation.

Quick Start

To start, review the Skill Development frontmatter the repository provides, then adapt the SKILL.md body to your plugin's needs. Create references/ and scripts/ subdirectories as needed to house best-practice content and tooling.

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 using progressive disclosure?

Structure a Claude Code plugin skill by keeping the SKILL.md body lean with core concepts, then move detailed content into references/ and scripts/ subdirectories for on-demand access. This progressive disclosure pattern reduces cognitive load and speeds up loading.

What are the best practices for writing SKILL.md frontmatter?

Best practices for SKILL.md frontmatter involve following clear conventions to standardize plugin skill creation. Adhere to established frontmatter guidelines to ensure your plugin skill integrates properly with Claude Code and supports rapid team iteration.

How do I create reusable templates for Claude Code plugin development?

Create reusable templates for Claude Code plugin development by adapting the provided Skill Development frontmatter and SKILL.md body to your needs. Establish references/ and scripts/ subdirectories to house best-practice content and tooling for repeatable workflows.

Do I need external dependencies to build a Claude Code plugin skill?

No external dependencies are required to build a Claude Code plugin skill beyond standard plugin development tooling. You only need clear frontmatter conventions and the provided templates to start organizing references, scripts, and assets.

What is the best way to organize references and scripts in a plugin skill?

Organize references and scripts in a plugin skill by creating dedicated subdirectories within your repository. Place detailed best-practice content in references/ and tooling in scripts/, ensuring the SKILL.md body remains lean and core concepts load quickly.

Why does my Claude Code plugin skill load slowly or cause cognitive overload?

Your Claude Code plugin skill likely loads slowly because the SKILL.md body contains too much detail. Apply progressive disclosure by moving detailed content to references/ and scripts/ subdirectories, keeping core content lean for rapid access.