skills.rest
alexajuno
alexajunoCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

skill-development

Guide creation and refinement of Skills for Claude Code plugins.

Updated Feb 16, 2026
Search Tags:#skill development#best practices#documentation#claude code#plugin development#progressive disclosure
One-click install
npx skills add https://github.com/alexajuno/dotfiles --skill skill-development-alexajuno
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-development
Source: https://github.com/alexajuno/dotfiles/tree/main/dot_claude/plugins/marketplaces/claude-plugins-official/plugins/plugin-dev/skills/skill-development
Command: npx skills add https://github.com/alexajuno/dotfiles --skill skill-development-alexajuno

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes 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 user-friendly.

Core Features & Use Cases

  • Skill Anatomy: Understand the required SKILL.md and optional scripts/, references/, assets/ directories.
  • 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 clarity.
  • Use Case: When you need to create a new skill for your plugin, understand its structure, or improve an existing one's discoverability and content organization.

Quick Start

Follow the step-by-step guide 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 create a new skill for a Claude Code plugin?▼

To create a new skill for a Claude Code plugin, structure your project with a required SKILL.md file and optional directories like scripts/, references/, and assets/ to organize content effectively for AI comprehension.

What is progressive disclosure in Claude Code skill development?▼

Progressive disclosure in skill development manages context by keeping the main SKILL.md file lean while placing detailed information and documentation inside the references/ directory for better efficiency.

What writing style should I use for Claude Code skills?▼

You should use the imperative or infinitive form and third-person descriptions for your Claude Code skills to ensure maximum AI clarity and comprehension during plugin processing.

How do I improve the discoverability of my Claude Code plugin skills?▼

Improve skill discoverability by following best practices for content organization, applying progressive disclosure principles, and using the imperative writing style to enhance AI comprehension.

Do I need to use the references directory when building a Claude Code skill?▼

Using the references directory is optional but recommended for Claude Code skills to manage context effectively through progressive disclosure, keeping your main SKILL.md file lean and efficient.

Related Skills

Explore More Software Engineering Skills→
oaustegardoaustegard
137

versioning-skills

Initialize Git repositories and commit changes for skill directories.

Community
Basic
emdashcodesemdashcodes
13

claude-code-plugins

Plan, package, and distribute Claude Code plugins and marketplaces.

Community
Intermediate
louloulinlouloulin
19

skill-md-validator

Validate SKILL.md files for YAML frontmatter, required fields, and content.

Community
Basic
act70255act70255

api-documenter

Generate SDKs and interactive developer portals from OpenAPI 3.1 specifications.

Community
Advanced