skills.rest
opensesh
openseshCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

Skill Development

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

Updated Aug 23, 2026
Search Tags:#skill development#best practices#documentation#claude code#ai agent#plugin development
One-click install
npx skills add https://github.com/opensesh/BOS-2.0 --skill skill-development-opensesh
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: Skill Development
Source: https://github.com/opensesh/BOS-2.0/tree/main/.claude/plugins/plugin-dev/skills/skill-development
Command: npx skills add https://github.com/opensesh/BOS-2.0 --skill skill-development-opensesh

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 validating effective skills for Claude Code plugins, ensuring they are discoverable, efficient, and user-friendly.

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 moving detailed information to reference files.
  • Writing Style: Master imperative/infinitive form and third-person descriptions for AI consumption.
  • Use Case: A developer wants to create a new skill for their plugin to handle complex API interactions. They can use this Skill to understand the best way to structure their SKILL.md, organize documentation in references/, and write clear, actionable instructions.

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

To structure a skill for a Claude Code plugin, use a specific anatomy including a SKILL.md file, and organize supporting code or documentation into scripts/, references/, and assets/ directories.

What is progressive disclosure in AI agent skill development?▼

Progressive disclosure in skill development manages context efficiently by moving detailed information out of the main instructions into separate reference files for the AI agent to consume.

What writing style should I use for Claude Code skill documentation?▼

Use imperative or infinitive verb forms and write third-person descriptions for Claude Code skill documentation to ensure clear, actionable instructions optimized for AI consumption.

How do I validate best practices when I create a new skill?▼

Validate best practices when you create a new skill by following provided guidelines on skill anatomy, progressive disclosure, and writing style, while actively checking for common mistakes.

What are common mistakes in Claude Code plugin development?▼

Common mistakes in Claude Code plugin development include poor context management, failing to use progressive disclosure, and writing documentation that is not optimized for AI consumption.

Related Skills

Explore More Software Engineering Skills→
Fr-e-dFr-e-d
157

architecture-extract

Analyze project directory structures to generate architectural summaries.

Community
Basic
lee-tolee-to
56

aif-loop

Orchestrate iterative artifact refinement through PLAN, PRODUCE, PREPARE, EVALUATE, CRITIQUE, and REFINE phases.

Community
Advanced
0xharryriddle0xharryriddle
3

context-fundamentals

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

Community
Advanced
pur3v4d3rpur3v4d3r
6

prompt-engineering

Apply prompt engineering patterns like Few-Shot Learning and Chain-of-Thought.

Community
Advanced