skills.rest
ace8991
ace8991COMMUNITY
Explore all skills by this author →
GitHub

Skill Development

Guides creation of Claude Code plugin skills with progressive disclosure structure.

Updated Mar 22, 2026
Search Tags:#documentation#claude code#skill creation#plugin development#progressive disclosure#yaml frontmatter#trigger phrases
One-click install
npx skills add https://github.com/ace8991/agentos --skill skill-development-ace8991
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: Skill Development
Source: https://github.com/ace8991/agentos/tree/main/.tmp_claude_code/claude-code-main/plugins/plugin-dev/skills/skill-development
Command: npx skills add https://github.com/ace8991/agentos --skill skill-development-ace8991

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Creating effective skills for Claude Code plugins requires understanding SKILL.md structure, YAML frontmatter conventions, trigger phrase design, and progressive disclosure principles, which are easy to get wrong without guidance. ## Core Features & Use Cases - Skill Creation Workflow: Follows a six-step process covering use case analysis, resource planning, structure creation, editing, validation, and iteration. - Progressive Disclosure Guidance: Explains what content belongs in SKILL.md versus references/, examples/, and scripts/ directories to keep context lean. - Writing Style Enforcement: Defines rules for third-person descriptions with trigger phrases and imperative/infinitive body writing. - Use Case: When a user asks to "create a skill" or "add a skill to plugin", this skill walks through designing trigger phrases, organizing bundled resources, and validating the result against a checklist. ## Quick Start Ask the assistant to create a new skill for your Claude Code plugin and follow the guided creation process.

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 skill for a Claude Code plugin?▼

Create a directory under the plugin's skills/ folder containing a SKILL.md file with YAML frontmatter defining name and description. Follow the six-step process: understand use cases, plan reusable resources, create structure, edit content, validate, and iterate.

What should go in a skill description for Claude Code?▼

Write the description in third person starting with "This skill should be used when" and include specific trigger phrases users would say, such as "create a hook" or "configure settings". Avoid vague or second-person descriptions.

What is progressive disclosure in Claude Code skills?▼

Progressive disclosure is a three-level loading system: metadata stays always in context, the SKILL.md body loads when the skill triggers, and bundled resources like references and scripts load only as needed. This keeps context usage efficient.

How long should a SKILL.md file be?▼

Keep the SKILL.md body between 1,500 and 2,000 words, with a hard limit under 5,000 words. Move detailed patterns, API documentation, and advanced techniques into references/ files that load only when needed.

When should I add scripts or references to a skill?▼

Add scripts when the same code is rewritten repeatedly or deterministic execution is needed. Add references for documentation Claude should consult while working, such as schemas, API specs, or detailed workflow guides.

Related Skills

Explore More Software Engineering Skills→
syahiidkamilsyahiidkamil
316

skill-creator

Guide users through designing, documenting, and evaluating Claude Code skills.

Community
Advanced
iVintikiVintik

diagnose

Diagnose Claude Code plugin skill load, trigger, and runtime failures.

Community
Intermediate
dotBeepsdotBeeps

skill-designer

Scaffold agent skills with validated SKILL.md frontmatter and structured directories.

Community
Intermediate
lukacflukacf
19

skill-creator

Create and package Claude skills using templates and scaffolding scripts.

Community
Intermediate