Skill Development

Guide creating and refining Claude Code plugin skills with SKILL.md structure.

21|4|Updated Mar 14, 2026

Search Tags:#skill development #documentation #claude code #plugin development #progressive disclosure #ai skills

Ready to run

npx skills add https://github.com/HaipingXu/social-science-claude-scholar --skill skill-development-haipingxu

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: Skill Development
Source: https://github.com/HaipingXu/social-science-claude-scholar/tree/main/skills/skill-development
Command: npx skills add https://github.com/HaipingXu/social-science-claude-scholar --skill skill-development-haipingxu

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 structure of a skill, including SKILL.md, scripts/, references/, and assets/.
Progressive Disclosure: Learn how to manage context by placing detailed information in references/ and keeping SKILL.md lean.
Writing Style: Master the imperative/infinitive form and third-person descriptions for AI consumption.
Use Case: When you need to create a new skill for your plugin, or improve an existing one, this Skill will guide you through the process from planning to testing.

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

To structure Claude skills for progressive disclosure, keep the SKILL.md file lean and place detailed information in the references/ directory, ensuring efficient context management and AI agent augmentation.

What is the correct writing style for Claude Code skill documentation?▼

Claude Code skill documentation should use the imperative or infinitive verb form and third-person descriptions to ensure optimal consumption and processing by the AI agent.

What components make up a Claude Code skill anatomy?▼

Claude skill anatomy consists of a SKILL.md file, a scripts/ directory for executable logic, a references/ directory for detailed data, and an assets/ folder for static resources.

How do I test and refine AI skills for Claude Code plugins?▼

You test and refine AI skills by following structured methodologies that evaluate the skill anatomy, writing style, and resource management, ensuring the Claude Code plugin remains discoverable and effective.

Do I need prior plugin development experience to create Claude skills?▼

No prior plugin development experience is strictly required, as this skill provides comprehensive guidance covering structure, writing style, resource management, and testing methodologies from planning to deployment.