Skill Development

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

Updated Feb 18, 2026
One-click install
npx skills add https://github.com/zach-source/claude-plugins --skill skill-development-zach-source
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Skill Development
Source: https://github.com/zach-source/claude-plugins/tree/main/plugins/plugin-dev/skills/skill-development
Command: npx skills add https://github.com/zach-source/claude-plugins --skill skill-development-zach-source

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides comprehensive guidance and best practices for creating, structuring, and refining skills for Claude Code plugins, ensuring they are discoverable, efficient, and effective.

Core Features & Use Cases

  • Skill Anatomy: Understand the essential components of a skill (SKILL.md, scripts/, references/, assets/).
  • Progressive Disclosure: Learn how to manage context efficiently by strategically placing information.
  • Writing Best Practices: Master imperative writing style and third-person descriptions for AI consumption.
  • Use Case: You're developing a new plugin and need to create a skill to handle user authentication. This Skill will guide you through defining its purpose, structuring its files, writing its SKILL.md, and ensuring it's discoverable by Claude.

Quick Start

Use the Skill Development skill to learn how to create a new skill for a Claude plugin.

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 AI consumption?

Progressive disclosure is a context management principle that strategically places information to optimize AI token usage. It prevents context overload by revealing detailed instructions only when needed during skill execution.

What is progressive disclosure in skill creation?

Progressive disclosure is a context management principle that strategically places information to optimize AI token usage. It prevents context overload by revealing detailed instructions only when needed during skill execution.

What writing style should I use for SKILL.md files?

A skill should bundle scripts for executable logic, references for detailed documentation, and assets for static resources. These components support the core SKILL.md by providing depth without cluttering the primary context window.

How do I make a Claude plugin skill discoverable?

To make a skill discoverable, define a clear purpose in the SKILL.md and organize content using progressive disclosure principles. Strategic placement of keywords and concise descriptions ensures Claude triggers the skill appropriately.