Skill Development

Guide creation of Claude Code plugin skills with lean SKILL.md files.

Updated May 15, 2026
One-click install
npx skills add https://github.com/nachopalmeri/agents-system --skill skill-development-nachopalmeri
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Skill Development
Source: https://github.com/nachopalmeri/agents-system/tree/main/.agents/skills/skill-development
Command: npx skills add https://github.com/nachopalmeri/agents-system --skill skill-development-nachopalmeri

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The Skill Development framework provides a repeatable, structured methodology for creating, organizing, and validating Claude Code plugin skills, enabling lean SKILL.md, progressive disclosure, and linked references, examples, and scripts.

Core Features & Use Cases

  • Standard SKILL.md templates with required frontmatter
  • Progressive disclosure to references and assets
  • Validation guidance for triggers, structure, and resources
  • Practical workflows for building, testing, and iterating skills

Quick Start

Create a new skill by drafting SKILL.md with proper frontmatter and progressively add references, examples, and scripts 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 proper frontmatter?

To create a Claude Code plugin skill, draft a lean SKILL.md file with required frontmatter. You progressively add references, examples, and scripts as needed to ensure proper structure and validation.

What is progressive disclosure in Claude Code skill development?

Progressive disclosure in skill development is a design methodology that keeps SKILL.md bodies lean by linking to external references, runnable examples, and scripts rather than embedding all content directly.

How do I validate triggers and structure when building Claude Code skills?

Validating Claude Code skill triggers and structure involves checking the required frontmatter standards, ensuring the lean SKILL.md body adheres to templates, and verifying that external references and examples are properly linked.

Do I need external dependencies to develop a Claude Code skill?

You do not need external dependencies to develop a Claude Code skill. The framework provides a structured methodology using standard SKILL.md templates, frontmatter, and progressive disclosure without requiring additional packages.

What's the best way to organize Claude Code plugin content and references?

The best way to organize Claude Code plugin content is maintaining a lean SKILL.md body and using progressive disclosure to link out to references, examples, and scripts, keeping the main file uncluttered.

When should I not use progressive disclosure for skill documentation?

You should reconsider progressive disclosure when your skill logic is too simple to warrant external files, though the framework generally enforces lean SKILL.md bodies with linked references and runnable examples for maintainability.