skills.rest
dobrinz123
dobrinz123COMMUNITY
Explore all skills by this author →
GitHub

skill-development

Creates and structures Claude Code plugin skills with SKILL.md frontmatter and progressive disclosure.

Updated Apr 9, 2026
Search Tags:#documentation#validation#skills#plugin#skill-development#claude-code#progressive-disclosure
One-click install
npx skills add https://github.com/dobrinz123/claude-skills-share --skill skill-development-dobrinz123
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-development
Source: https://github.com/dobrinz123/claude-skills-share/tree/main/plugins/plugin-dev/skills/skill-development
Command: npx skills add https://github.com/dobrinz123/claude-skills-share --skill skill-development-dobrinz123

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Provide a consistent, repeatable process for creating, organizing, and validating Claude Code plugin skills so they are discoverable, maintainable, and efficient to load during runtime. Reduce ambiguity around SKILL.md frontmatter, progressive disclosure, and resource structuring to avoid bloated contexts and broken references.

Core Features & Use Cases

  • Authoring guidelines: Explain required YAML frontmatter fields, third-person trigger phrasing, and imperative writing style for SKILL.md.
  • Progressive disclosure: Advise what belongs in SKILL.md versus references/, examples/, and scripts/ to minimize context load and enable on-demand resource loading.
  • Validation and packaging: Provide a checklist to validate frontmatter, referenced files, script executability, and packaging steps for distribution.
  • Use Case: Help a plugin developer structure a new skill with SKILL.md, move long docs into references/, add example scripts, and run validation before publishing.

Quick Start

Ask Claude to generate a SKILL.md frontmatter with a clear name and third-person description containing trigger phrases, a concise imperative-body that references supporting files in references/, and a validation checklist to follow.

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

Claude Code plugin skills require a lean SKILL.md body with YAML frontmatter, moving long documentation into a references/ directory to enable on-demand resource loading and reduce context bloat. Supporting examples and executable scripts are organized in their respective subdirectories.

What should be included in SKILL.md frontmatter for a plugin skill?▼

SKILL.md frontmatter must include a name and a third-person description containing trigger phrases. This ensures the skill is discoverable during runtime by matching user intents to the appropriate plugin skill package.

How do I validate Claude Code plugin skills before publishing?▼

Validating plugin skills involves checking YAML frontmatter completeness, verifying that all files referenced in the SKILL.md body exist in references/ or examples/, confirming script executability, and running through a packaging checklist for distribution.

When should I move documentation into references/ instead of keeping it in SKILL.md?▼

Move documentation into references/ when content exceeds the lean imperative body needed for immediate context. Progressive disclosure keeps SKILL.md minimal for efficient runtime loading while allowing Claude to access detailed resources on demand.

Can I add executable scripts to a Claude Code plugin skill package?▼

Yes, optional executable scripts can be added to plugin skill packages for deterministic tasks. These scripts are organized within the skill structure and validated for executability during the packaging workflow before distribution.

Why does my Claude Code skill fail to trigger during runtime?▼

Skills fail to trigger when the SKILL.md frontmatter lacks a third-person description with proper trigger phrases or when the body is bloated instead of lean. Enforce correct YAML fields and imperative writing style to ensure discoverability.

Related Skills

Explore More Software Engineering Skills→
powdreampowdream

add-plugin

Scaffold and publish Claude plugins with plugin.json and marketplace.json registration.

Community
Basic
kcns008kcns008
5

skill-creator

Create reusable AgentSkill directories from a standardized template.

Community
Intermediate
LionelDraghiLionelDraghi
28

bbt-user

Parse SKILL.md frontmatter to index Skill Units with YAML metadata.

Community
Advanced
zzafergokzzafergok
1

markdown-to-html-skill

Convert Markdown documents to HTML using marked.js, pandoc, gomarkdown, or static site generators.

Community
Intermediate