skill-development

Name: skill-development
Availability: InStock
Author: TheVibeWorks

Create and structure Claude Code plugin skills with YAML frontmatter and progressive disclosure.

28|5|Updated Jun 24, 2025

Search Tags:#claude code #plugin development #skill authoring #progressive disclosure #yaml frontmatter #documentation structure #instruction writing

Ready to run

npx skills add https://github.com/thevibeworks/claude-code-docs --skill skill-development-thevibeworks

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: skill-development
Source: https://github.com/thevibeworks/claude-code-docs/tree/main/content/github/claude-plugins-official/plugins/plugin-dev/skills/skill-development
Command: npx skills add https://github.com/thevibeworks/claude-code-docs --skill skill-development-thevibeworks

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill solves the problem of unclear, inconsistent, or poorly structured Claude Code plugin skills by providing actionable guidance for designing the right skill structure, progressive disclosure, and metadata so skills are discoverable and reliable.

Core Features & Use Cases

Skill architecture guidance: Explain what a skill is, what belongs in SKILL.md vs optional bundled resources, and how to keep the skill lean while still comprehensive.
Best practices for triggers and metadata: Write strong YAML frontmatter name and description with specific third-person trigger phrases that match user intent.
Progressive disclosure design: Use a layered loading approach so metadata loads first, instructions load on trigger, and references/scripts/assets load only when needed.
Authoring workflow: Follow a step-by-step process for planning content, creating directory structure, writing the body in imperative/infinitive form, and validating/test readiness.

Quick Start

Ask Claude to design a new Claude Code plugin skill by outlining the SKILL.md frontmatter triggers and planning what should go into scripts/, references/, and assets/.

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 discoverability?▼

Structure a Claude Code plugin skill by writing YAML frontmatter with specific third-person trigger phrases in the name and description fields that match user intent. This ensures the skill is discoverable and reliably triggered by Claude Code.

What is progressive disclosure in skill authoring?▼

Progressive disclosure in skill authoring is a layered loading approach where YAML metadata loads first, instructions load on trigger, and references, scripts, or assets load only when needed. This design keeps Claude Code skills lean while remaining comprehensive.

What should go into SKILL.md versus bundled resources?▼

SKILL.md should contain core imperative and infinitive instructions along with YAML frontmatter. Optional bundled resources like scripts, references, and assets should be separated out to maintain a lean skill structure and loaded only when required by the task.

How do I write instructions for a Claude Code skill?▼

Write Claude Code skill instructions using imperative and infinitive verb forms to provide direct, actionable guidance. This authoring style ensures Claude processes the directives correctly and executes the intended tasks without ambiguity.

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

No dependencies are required to create a Claude Code skill. You can plan content, create the directory structure, write the SKILL.md body, and validate test readiness independently using standard YAML frontmatter and Markdown formatting.