skills.rest
HaipingXu
HaipingXuCOMMUNITY
Explore all skills by this author →
GitHub

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
One-click install
npx skills add https://github.com/HaipingXu/social-science-claude-scholar --skill skill-development-haipingxu
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
stevenmunozstevenmunoz

skill-creator

Generate standardized SKILL.md scaffolds and bundled resources for Claude skills.

Community
Advanced
vonomarapvonomarap

skill-creator

Generate Claude skill scaffolds, validate YAML frontmatter, and package .skill ZIP archives.

Community
Intermediate
0xharryriddle0xharryriddle
3

context-fundamentals

Manage and optimize AI agent context with token budgets and progressive disclosure.

Community
Advanced
joncranglejoncrangle
8

skill-development

Create Claude Code plugin skills with SKILL.md structure and validation.

Community
Intermediate