Skill Development

Define Claude Code skills with SKILL.md frontmatter and modular resources.

2|1|Updated Mar 13, 2024
One-click install
npx skills add https://github.com/WingsZeng/dotfiles --skill skill-development-wingszeng
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Skill Development
Source: https://github.com/WingsZeng/dotfiles/tree/main/dot_config/goose/skills/skill-development
Command: npx skills add https://github.com/WingsZeng/dotfiles --skill skill-development-wingszeng

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Defines a structured, repeatable process for creating, documenting, and maintaining Claude Code plugin skills. It ensures consistent skill architecture, frontmatter quality, and lean core content while enabling scalable collaboration across teams.

Core Features & Use Cases

  • Standardized SKILL.md with third-person frontmatter and a lean body that triggers when needed.
  • Progressive disclosure guidance that moves detailed content into references/, examples/, and scripts/ to minimize context load.
  • Validation and testing mindset including clear criteria for structure, triggers, and references, plus recommended workflow for iteration.
  • Use cases include designing new skills, updating existing ones, refining activation phrases, and organizing skill content for reuse.

Quick Start

Outline concrete skill use cases and create reusable resources in scripts, references, and assets to begin.

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 consistent team deployment?

Structure Claude Code plugin skills using standardized SKILL.md frontmatter and lean bodies. Move detailed content into modular references, examples, and scripts to support progressive disclosure and minimize context load during deployment.

What is progressive disclosure in Claude Code skills and when should I use it?

Progressive disclosure in Claude Code skills moves detailed content into references, scripts, and assets rather than the main body. Use it to minimize context load and trigger specific skill content only when needed during execution.

How do I write SKILL.md frontmatter to ensure my plugin skill triggers correctly?

Write SKILL.md frontmatter in third-person with clear activation phrases and concise descriptions. Keep the body lean so the skill triggers when needed, moving supporting details to structured references and scripts.

Does building Claude Code skills require external dependencies or scripts?

Building Claude Code skills requires no external dependencies. You create reusable resources natively in scripts, references, and assets directories to support the skill's core logic and progressive disclosure.

What's the best way to organize skill content for reuse across multiple plugin teams?

Organize skill content by separating lean core logic in SKILL.md from detailed resources in references, examples, and scripts. This modular structure enables scalable collaboration and consistent skill architecture across teams.

Why does my Claude Code skill fail to activate even with correct frontmatter?

Claude Code skills may fail to activate if the SKILL.md body is too heavy or lacks clear triggers. Ensure frontmatter is third-person, the body is lean, and supporting content uses progressive disclosure via references.