Skill Development

Guide creation and refinement of Claude Code plugin skills with modular structure.

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

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 effective, modular, and discoverable skills for Claude Code plugins, ensuring efficient AI agent development.

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 efficiently by organizing content across different skill components.
  • Writing Best Practices: Master imperative writing style, third-person descriptions, and specific trigger phrases for optimal AI interaction.
  • Use Case: A developer needs to create a new skill for their plugin to handle complex API interactions. They consult this Skill to understand the best way to structure the skill, write its SKILL.md, and organize necessary reference documents and utility scripts.

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 effectively?

To structure a Claude Code plugin skill, organize your project using a SKILL.md file alongside scripts, references, and assets directories to ensure modular content organization and efficient AI interaction.

What is progressive disclosure in AI agent plugin development?

Progressive disclosure in AI agent plugin development is a context management technique that organizes content across different skill components to prevent context overload and optimize AI processing.

How do I write SKILL.md files for optimal AI interaction?

Writing SKILL.md files for optimal AI interaction requires using an imperative writing style, third-person descriptions, and specific trigger phrases to guide the AI agent's behavior accurately.

What are the best practices for Claude Code plugin skill creation?

Best practices for Claude Code plugin skill creation involve maintaining modularity, applying progressive disclosure, using imperative writing, and validating your skill structure for effective AI agent development.

Do I need utility scripts when developing AI agent skills?

You need utility scripts when developing AI agent skills to handle complex API interactions and execute logic that standard markdown documentation cannot perform independently.

When should I use references instead of scripts in skill development?

Use references instead of scripts in skill development when you need to provide static context, documentation, or guidelines to the AI agent rather than executing dynamic operations or API interactions.