skill-development

Create Claude Code plugin skills with SKILL.md structure and YAML frontmatter.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/julianobarbosa/.claude --skill skill-development-julianobarbosa
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-development
Source: https://github.com/julianobarbosa/.claude/tree/main/plugins/marketplaces/claude-plugins-official/plugins/plugin-dev/skills/skill-development
Command: npx skills add https://github.com/julianobarbosa/.claude --skill skill-development-julianobarbosa

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It solves the problem of building effective, discoverable Claude Code plugin skills by providing best-practice guidance for structuring SKILL.md, defining high-quality trigger descriptions, and keeping content organized for reliable context loading.

Core Features & Use Cases

  • Skill architecture guidance: Explains the required SKILL.md anatomy and how optional bundled resources (scripts, references, assets) should be organized inside a skill directory.
  • Metadata and trigger crafting: Provides instructions for writing YAML frontmatter with a precise name/description and third-person phrasing that includes concrete trigger phrases users would say.
  • Progressive disclosure design: Recommends what belongs in the SKILL.md body versus what should move into references/ to control context size while still making necessary details available.
  • Claude Code plugin workflow support: Covers a step-by-step process for creating, editing, validating, and iterating plugin skills, including testing and validation checklists.

Quick Start

Ask the skill to help you write or refine a Claude Code plugin skill by describing the functionality you want and the exact user phrases that should trigger it.

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.md file for a Claude Code plugin?

A Claude Code plugin skill requires a SKILL.md file with YAML frontmatter containing a name and trigger-based description, followed by an imperative-style body that uses progressive disclosure to reference bundled scripts and references.

What is progressive disclosure in Claude Code skill development?

Progressive disclosure in skill development is the practice of keeping core instructions in the SKILL.md body while moving detailed scripts, references, and assets into separate files, controlling context size while keeping necessary details available for loading.

How do I write trigger phrases for Claude Code skill metadata?

Write trigger phrases for Claude Code skill metadata by crafting a third-person YAML frontmatter description that includes concrete phrases users would naturally say to invoke the specific functionality.

Can I add references and scripts to a Claude Code skill directory?

Yes, you can add references and scripts to a Claude Code skill directory. The skill architecture supports bundling optional resources like scripts, references, and assets alongside the SKILL.md file for reliable context loading.

What is the best way to validate a Claude Code plugin skill?

The best way to validate a Claude Code plugin skill is to follow a step-by-step workflow that includes testing trigger phrases, checking YAML frontmatter structure, and iterating on the skill description for better discovery.

Why does my Claude Code skill description not trigger correctly?

Your Claude Code skill description may not trigger correctly if the YAML frontmatter lacks concrete trigger phrases or is not written in the third person, which are required for proper discovery and context loading.