Skill Development

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

Updated Jan 21, 2026
One-click install
npx skills add https://github.com/mbarnes-code/multi-agent-vllm --skill skill-development-mbarnes-code
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Skill Development
Source: https://github.com/mbarnes-code/multi-agent-vllm/tree/main/features/claude-plugins-official/plugins/plugin-dev/skills/skill-development
Command: npx skills add https://github.com/mbarnes-code/multi-agent-vllm --skill skill-development-mbarnes-code

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and scripts (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 Structure Guidance: Understand the anatomy of a skill, including SKILL.md and bundled resources (scripts/, references/, assets/).
  • Best Practice Adherence: Learn about progressive disclosure, writing style (imperative/infinitive, third-person descriptions), and content organization.
  • Use Case: A developer wants to add a new skill to their plugin to handle API documentation lookup. They can use this Skill to understand how to structure the SKILL.md, where to place API reference files, and how to write effective trigger phrases.

Quick Start

Use the Skill Development skill to learn how to create a new skill for a Claude Code 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?

A Claude Code plugin skill requires a main SKILL.md file alongside bundled resources like scripts, references, and assets directories to ensure modular and self-contained extensions to AI capabilities.

What are the best practices for writing Claude Code skill documentation?

Best practices for Claude Code skill documentation include using an imperative and infinitive writing style, writing in third-person descriptions, and organizing content to ensure discoverability and efficient execution.

What is progressive disclosure in AI skill development?

Progressive disclosure in AI skill development is a content organization best practice that structures modular, self-contained extensions to manage specialized knowledge and workflows efficiently without overwhelming the context window.

Can I use skill development guides to add API documentation lookup to a plugin?

Yes, you can use skill development guides to understand how to structure the SKILL.md file, place API reference files in the appropriate directories, and write effective trigger phrases for API documentation lookup workflows.

When do I need to create a new skill for a Claude Code plugin?

You need to create a new skill for a Claude Code plugin when you need modular, self-contained extensions to AI capabilities with specialized knowledge and workflows that are not already covered by existing skills.