skills.rest
CuCryptos
CuCryptosCOMMUNITY
Explore all skills by this author →
GitHub

Skill Development

Guide creation and structuring of Claude Code plugin skills with SKILL.md metadata.

Updated Jan 29, 2026
Search Tags:#skill development#best practices#documentation#claude code#plugin development#progressive disclosure
One-click install
npx skills add https://github.com/CuCryptos/sixroundsdeep --skill skill-development-cucryptos
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: Skill Development
Source: https://github.com/CuCryptos/sixroundsdeep/tree/main/.agents/skills/skill-development
Command: npx skills add https://github.com/CuCryptos/sixroundsdeep --skill skill-development-cucryptos

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 optimizing skills for Claude Code plugins, ensuring discoverability and efficient context management.

Core Features & Use Cases

  • Skill Structure Guidance: Understand the anatomy of a skill, including SKILL.md and optional resources (scripts/, references/, assets/).
  • Metadata Best Practices: Learn how to write effective name and description for discoverability.
  • Progressive Disclosure: Implement efficient context loading by organizing content across SKILL.md, references/, and examples/.
  • Use Case: A developer wants to create a new skill for their plugin to handle complex API interactions. They use this Skill to understand the best way to structure their SKILL.md, organize API documentation in references/, and provide example usage in examples/.

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 for progressive disclosure?▼

Effective Claude Code skill creation requires writing imperative SKILL.md content, using third-person descriptions for AI consumption, and organizing bundled resources like scripts and references to optimize discoverability.

What is the best way to write metadata for a Claude Code skill?▼

To implement progressive disclosure, place primary instructions in SKILL.md and distribute detailed API documentation or examples into references and examples directories. This approach manages context loading efficiently.

How do I organize bundled resources like scripts and references in a plugin?▼

When creating a skill for complex API interactions, structure your SKILL.md with core logic, place API documentation in the references directory, and provide example usage in the examples directory to guide the AI effectively.

Can I use third-person descriptions for AI consumption in SKILL.md?▼

Yes, you can structure bundled resources by placing API documentation in references, example usage in examples, and core logic in SKILL.md. This organization optimizes context loading for complex interactions.

Related Skills

Explore More Software Engineering Skills→
blueif16blueif16

{{SKILL_NAME}}

Scaffold Claude plugin structures with YAML frontmatter and documentation templates.

Community
Advanced
Conte777Conte777

skill-development

Create Claude Code plugin skills with a structured SKILL.md blueprint.

Community
Advanced
windyskywindysky

moai-docs-generation

Generate documentation patterns from code for Sphinx, MkDocs, TypeDoc, and Nextra.

Community
Advanced
AgnosticSixAgnosticSix
4

agent-md-refactor

Refactor monolithic AGENTS.md files into modular AGENTS.md and SKILLS.md documents.

Community
Intermediate