Skill Development

Organize Claude Code skill structure and documentation with SKILL.md frontmatter.

43|9|Updated Nov 16, 2025

Search Tags:#skill-development #claude-code #progressive-disclosure #yaml-frontmatter #plugin-skills

Ready to run

npx skills add https://github.com/ssdeanx/AgentStack --skill skill-development-ssdeanx

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: Skill Development
Source: https://github.com/ssdeanx/AgentStack/tree/main/.github/skills/skill-development
Command: npx skills add https://github.com/ssdeanx/AgentStack --skill skill-development-ssdeanx

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

The Skill Development framework provides structured guidance to design, document, and maintain Claude Code skills. It clarifies how to compose SKILL.md frontmatter, assemble optional references, assets, and scripts, and enforce progressive disclosure to optimize loading context.

Core Features & Use Cases

Define a consistent SKILL.md structure with mandatory name and description frontmatter.
Organize bundled resources (references, assets, scripts) to balance lean core content with rich context as needed.
Guide plugin developers through a step-by-step Skill Creation Process, from understanding use cases to validation and iteration.
Ensure compliance with writing style, validation checks, and auto-discovery conventions for Claude Code plugins.

Quick Start

Follow the Skill Creation Process to draft a new skill by outlining use cases, creating SKILL.md with proper frontmatter, and populating references/ 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 structure a SKILL.md file for Claude Code plugin development?▼

To structure a SKILL.md file for Claude Code plugin development, you must include mandatory name and description YAML frontmatter, followed by lean core content. This ensures smooth loading and auto-discovery conventions are met for your plugin.

What is progressive disclosure in Claude Code skills?▼

Progressive disclosure in Claude Code skills is a design approach that balances lean core SKILL.md content with rich bundled context. It organizes optional references, assets, and scripts separately to optimize loading context and streamline skill creation.

What is the step-by-step process to create a new Claude Code skill?▼

The step-by-step Claude Code skill creation process involves outlining use cases, drafting a SKILL.md file with proper YAML frontmatter, populating bundled resources like references, and performing validation checks to ensure compliance and smooth loading.

Does AgentStack plugin development require YAML frontmatter validation?▼

Yes, AgentStack plugin development requires YAML frontmatter validation. Enforcing frontmatter validity and adherence to writing style conventions ensures your plugin skills load smoothly and integrate correctly within the AgentStack ecosystem.

When should I use bundled references instead of inline content in SKILL.md?▼

You should use bundled references instead of inline content in SKILL.md when you need to provide rich context without bloating the core file. This progressive disclosure strategy optimizes loading context by keeping the main SKILL.md lean.

Why does my Claude Code skill fail auto-discovery?▼

Your Claude Code skill may fail auto-discovery due to invalid YAML frontmatter, non-compliant writing style, or improper resource referencing. Enforcing validation checks and adhering to structural conventions ensures smooth loading and successful plugin integration.