Skill Development

Guide authors in structuring Claude Code plugin skills with SKILL.md and validation checklists.

Updated Feb 16, 2026
One-click install
npx skills add https://github.com/rbkayz/gitskills --skill skill-development-rbkayz
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Skill Development
Source: https://github.com/rbkayz/gitskills/tree/main/skills/registry/anthropics-skill-development
Command: npx skills add https://github.com/rbkayz/gitskills --skill skill-development-rbkayz

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill provides a comprehensive framework 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 essential components of a skill (SKILL.md, scripts/, references/, assets/).
  • Progressive Disclosure: Learn how to manage context efficiently by organizing information across different file types.
  • Writing Style Guidance: Master the imperative/infinitive form and third-person descriptions for AI consumption.
  • Use Case: A developer needs to create a new skill for their plugin to handle complex API interactions. They can use this skill to understand the required structure, best practices for documentation, and how to organize supporting scripts and reference materials.

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 structure a Claude Code plugin skill?

Structure a Claude Code plugin skill using a `SKILL.md` file alongside `scripts/`, `references/`, and `assets/` directories to separate executable logic from static context.

What is progressive disclosure when authoring AI agent capabilities?

Progressive disclosure manages context efficiently by organizing information across different file types, ensuring AI agents load only necessary details for a task.

What writing style does Claude require for skill documentation?

Skill documentation requires imperative and infinitive verb forms with third-person descriptions to optimize AI consumption and ensure accurate processing.

Can I use scripts and references to handle complex API interactions in plugins?

Yes, you can use the `scripts` component for executable logic and `references` for static context to build high-quality skills that handle complex API interactions.

What's the best way to validate a newly created skill before deployment?

Validate a newly created skill using a validation checklist to ensure it meets discoverability, efficiency, and structural requirements for Claude Code plugins.