skills.rest
tzachbon
tzachbonCOMMUNITY
Explore all skills by this author →
Website𝕏@tzachbonfilGitHub

Skill Development

Design Claude Code plugin skills with SKILL.md frontmatter and resource organization.

432|40|Updated Jan 11, 2026
Search Tags:#Claude Code#guidelines#skill-development#SKILL.md#frontmatter#progressive-disclosure#plugin-skills
One-click install
npx skills add https://github.com/tzachbon/smart-ralph --skill skill-development-tzachbon
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: Skill Development
Source: https://github.com/tzachbon/smart-ralph/tree/main/.agents/skills/Skill%20Development
Command: npx skills add https://github.com/tzachbon/smart-ralph --skill skill-development-tzachbon

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

The Skill Development unit provides a structured blueprint for creating, refining, and organizing Claude Code plugin skills. It clarifies how to craft SKILL.md with proper frontmatter, assemble references, examples, and scripts, and enforces progressive disclosure to keep context lean during runtime.

Core Features & Use Cases

  • Define the Skill skeleton: SKILL.md frontmatter with required name and description and a concise Markdown body with procedural guidance.
  • Organize resources: guidance on placing reusable content in references/, examples/, scripts/ and when to load them.
  • Validate and iterate: establishes best practices for plugin skills, progressive disclosure, and testing, enabling consistent quality improvements over time.

Quick Start

  • To create or refine a Skill, prepare SKILL.md with frontmatter, add a references/ directory with supporting docs, and include an examples/ folder with working illustrations. Use the references/ to store patterns, migration notes, and API references; scripts/ can host utilities if deterministic tasks are needed.

Frequently Asked Questions about Skill Development

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I build a Claude Code plugin skill?▼

Building a Claude Code plugin skill requires creating a SKILL.md file with frontmatter fields like name and description, then organizing supporting content into references/ and examples/ directories to keep runtime context lean.

What is progressive disclosure in Claude Code skills?▼

Progressive disclosure in Claude Code skills is the practice of organizing resources into references/, examples/, and scripts/ directories so only necessary context loads during runtime, keeping the context lean and efficient.

How do I structure SKILL.md frontmatter for a plugin skill?▼

Structuring SKILL.md frontmatter requires including the skill name and description as mandatory fields, followed by a concise Markdown body containing procedural guidance for the skill's core task.

When should I use the references directory in skill development?▼

Use the references/ directory during skill development to store reusable content such as API references, migration notes, and design patterns that should only load into context when needed.

What are the best practices for organizing Claude Code skill resources?▼

Best practices for organizing Claude Code skill resources include placing reusable documentation in references/, working illustrations in examples/, and deterministic utilities in scripts/ to enforce progressive disclosure and enable consistent quality.

Can I include scripts in my Claude Code plugin skill?▼

Yes, you can include scripts in your Claude Code plugin skill by hosting deterministic task utilities in a scripts/ directory, keeping them separate from procedural guidance in SKILL.md.

Related Skills

Explore More Software Engineering Skills→
Claude-Code-Community-IrelandClaude-Code-Community-Ireland
10

Plugin Settings

Configure Claude Code plugins per project using `.claude/plugin-name.local.md` files with YAML frontmatter.

Official
Intermediate
AirmomoAirmomo

skill-development

Create, structure, and validate Claude Code Skill units with SKILL.md frontmatter.

Community
Advanced
TECHKNOWMAD-LABSTECHKNOWMAD-LABS

skill-validator

Validate Claude Code skills for YAML frontmatter, structure, scripts, and markdown.

Official
Intermediate
ironbobironbob

writing-skills

Create and validate SKILL.md files with YAML frontmatter constraints and RED-GREEN-REFACTOR testing workflow.

Community
Advanced