Skill Development

Creates and improves Claude Code plugin skills with SKILL.md guidance.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/a6232241/resume --skill skill-development-a6232241
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Skill Development
Source: https://github.com/a6232241/resume/tree/main/.agent/skills/skill-development
Command: npx skills add https://github.com/a6232241/resume --skill skill-development-a6232241

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, scripts/, references/, and assets/.
  • Best Practices: Learn about progressive disclosure, writing style (imperative form, third-person descriptions), and common mistakes to avoid.
  • Use Case: A developer needs to create a new skill for their plugin to handle API documentation. They can use this Skill to understand the required file structure, how to write an effective SKILL.md, and where to place API reference documents.

Quick Start

Follow the steps outlined in this skill to create a new skill for your 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 plugin for Claude Code?

Structure a Claude Code plugin by creating a root SKILL.md alongside scripts/, references/, and assets/ directories to define module anatomy and ensure proper functionality.

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

Best practices for writing SKILL.md documentation include using imperative form for instructions, third-person descriptions, and applying progressive disclosure to organize content efficiently.

How does progressive disclosure work when developing Claude Code skills?

Progressive disclosure in Claude Code skill development works by structuring content so that essential instructions are presented first, with deeper reference materials layered subsequently to optimize context efficiency.

What is the best way to validate a new skill for Claude Code?

The best way to validate a new skill for Claude Code is to follow the provided best practices for skill structure, content organization, and writing style to ensure the specialized module is discoverable and effective.

Can I use scripts and references directories to handle API documentation in Claude Code?

Yes, you can use the scripts and references directories to handle API documentation by placing API reference documents in references and executing related logic through scripts within your Claude Code plugin.

What are common mistakes to avoid when creating Claude Code skills?

Common mistakes to avoid when creating Claude Code skills include poor content organization, ignoring progressive disclosure principles, and using incorrect writing styles like first-person narratives instead of imperative instructions.