skills.rest
stevessr
stevessrCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

Skill Development

Create Claude Code plugin skills with lean SKILL.md frontmatter and progressive disclosure.

Updated Dec 1, 2025
Search Tags:#templates#skill-development#claude-code#references#progressive-disclosure#yaml-frontmatter#plugin-skills
One-click install
npx skills add https://github.com/stevessr/dotsfiles --skill skill-development-stevessr
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: Skill Development
Source: https://github.com/stevessr/dotsfiles/tree/main/dot_claude/private_plugins/private_marketplaces/claude-code-plugins/plugins/plugin-dev/skills/skill-development
Command: npx skills add https://github.com/stevessr/dotsfiles --skill skill-development-stevessr

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Provides a structured, reusable framework for creating and refining Claude Code plugin skills. Enables teams to capture consistent guidance, templates, and references while keeping SKILL.md lean, with detailed material organized in dedicated references and assets directories.

Core Features & Use Cases

  • Enforce YAML frontmatter with a precise, third-person description to determine when a skill loads.
  • Organize reusable resources into scripts/, references/, and assets/ to support deterministic tasks, knowledge references, and output templates.
  • Validate structure by ensuring SKILL.md exists, includes required fields (name, description), and that a Markdown body is present; use references to store in-depth details.
  • Provide clear templates and workflows for skill creation, testing, and iteration, including examples, references, and scripts that can be reused across skills.
  • Apply progressive disclosure to minimize context load: core concepts appear in SKILL.md; detailed guidance moves to references/.

Quick Start

Create a new skill directory under skills/skill-name, add a SKILL.md with frontmatter, and populate optional resources as needed.

Quick Start

Create a new skill directory under skills/skill-name, add a SKILL.md with frontmatter, and populate optional resources as needed.

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 structured YAML frontmatter?▼

To create a Claude Code plugin skill, establish a structured framework with a lean SKILL.md file containing precise YAML frontmatter. This enforces consistent quality by defining triggers and organizing resources into dedicated directories for deterministic task execution.

What is progressive disclosure in Claude Code skill development?▼

Progressive disclosure in Claude Code skill development minimizes context load by placing core concepts in SKILL.md while moving detailed guidance to references. This approach preserves thorough guidance by loading external resources and templates on demand only when needed.

How do I validate the structure of a Claude Code plugin skill?▼

Validate a Claude Code plugin skill by ensuring the SKILL.md file exists, includes required YAML frontmatter fields like name and description, and contains a Markdown body. Use references to store in-depth details and verify that scripts, assets, and references are correctly organized.

Does Claude Code skill development work without external dependencies?▼

Claude Code skill development operates without external dependencies by utilizing a self-contained framework. It enforces lean SKILL.md frontmatter and organizes reusable resources, templates, and scripts internally to support deterministic tasks and knowledge references.

Why should I use references and assets directories when building Claude Code skills?▼

References and assets directories should be used when building Claude Code skills to apply progressive disclosure and minimize context load. Organizing reusable resources into scripts, references, and assets supports deterministic tasks, knowledge references, and output templates effectively.

What is the best way to organize reusable templates for Claude Code plugin skills?▼

The best way to organize reusable templates for Claude Code plugin skills is applying a structured framework that separates resources into scripts, references, and assets directories. This ensures templates load on demand to minimize context load while preserving thorough guidance.

Related Skills

Explore More Software Engineering Skills→
pjy4617pjy4617

vivado-setup

Install six agents and CLAUDE.md into a target Vivado project.

Community
Advanced
rp1-runrp1-run
38

sample-skill

Parse SKILL.md front matter and extract name and description fields.

Official
Basic
rodrigobranasrodrigobranas
1

skill-best-practices

Validate agent skill metadata against the agentskills.io specification.

Community
Intermediate
struct-eng-rigenstruct-eng-rigen
2

Skill Development

Guide development and management of Claude Code plugin skills.

Community
Advanced