skill-development

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

Updated Oct 26, 2025

Search Tags:#Claude Code #SKILL.md #skill-creation #progressive-disclosure #plugin-development #documentation-template

Ready to run

npx skills add https://github.com/Conte777/config_for_claude_code --skill skill-development-conte777

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: skill-development
Source: https://github.com/Conte777/config_for_claude_code/tree/main/src/skills/skill-development
Command: npx skills add https://github.com/Conte777/config_for_claude_code --skill skill-development-conte777

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Claude Code plugin development often lacks a centralized, reusable blueprint for creating consistent, well-documented skills. This skill provides a structured guide that helps developers design, document, and assemble Claude Code plugin skills efficiently.

Core Features & Use Cases

Centralized SKILL.md template: ensures frontmatter with name and description and a lean body.
Progressive disclosure guidance: explain moving detailed content to references/, examples/, and scripts/.
Reference architecture: guidance on where to store patterns, advanced techniques, and migration guides in references/.
Examples and scripts scaffolding: templates and examples to accelerate skill creation.

Quick Start

To begin creating a new skill, prepare a directory named after the skill: skill-name/ SKILL.md Then implement core sections following this guide and add optional folders references/, examples/, and scripts/ as needed. Then describe usage and triggers in SKILL.md.

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

To create a Claude Code plugin skill, use a centralized SKILL.md template with frontmatter for name and description, then organize detailed content into references/ and examples/ folders to standardize documentation and optimize context loading.

What is progressive disclosure in Claude Code skill development?▼

Progressive disclosure in Claude Code skill development is the practice of keeping SKILL.md lean while moving detailed patterns, advanced techniques, and migration guides into references/ and examples/ directories to optimize context loading.

How do I structure a SKILL.md file for a Claude Code plugin?▼

Structure a SKILL.md file by including frontmatter with the skill name and description, followed by a lean body describing usage and triggers, while relocating exhaustive content to references/, examples/, and scripts/ folders.

What is the best way to document Claude Code plugin skills for reuse across projects?▼

The best way to document plugin skills for reuse is applying a centralized blueprint that separates the lean SKILL.md entry point from detailed scaffolding in references/ and examples/, ensuring consistent organization across projects.

Do I need any dependencies to build a Claude Code plugin skill?▼

No dependencies are required to build a Claude Code plugin skill using this blueprint. You only need to create a skill directory, implement the core SKILL.md sections, and add optional folders for references and examples as needed.

When should I move content into the references folder during skill creation?▼

Move content into the references folder during skill creation when it contains detailed patterns, advanced techniques, or migration guides that would otherwise bloat the SKILL.md file and degrade context loading efficiency.