skills.rest
FacuM
FacuMCOMMUNITY
Explore all skills by this author →
GitHub

skill-development

Creates Claude Code plugin skills with SKILL.md, scripts, references, and assets.

1|Updated Feb 24, 2026
Search Tags:#skill development#ai agent#developer guide#plugin architecture#claude plugins
One-click install
npx skills add https://github.com/FacuM/yolo-agent --skill skill-development-facum
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-development
Source: https://github.com/FacuM/yolo-agent/tree/main/.claude/skills/skill-development
Command: npx skills add https://github.com/FacuM/yolo-agent --skill skill-development-facum

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides comprehensive guidance and best practices for creating, structuring, and refining skills for Claude Code plugins, ensuring they are discoverable, efficient, and user-friendly.

Core Features & Use Cases

  • Skill Anatomy: Understand the structure of a skill, including SKILL.md, scripts/, references/, and assets/.
  • Progressive Disclosure: Learn how to manage context efficiently by placing detailed information in reference files.
  • Writing Style: Master the imperative/infinitive form and third-person descriptions for AI consumption.
  • Use Case: You're developing a new plugin and need to create a skill to handle user requests for generating API documentation. This Skill will guide you through defining triggers, structuring content, and organizing resources.

Quick Start

Follow the step-by-step guide to create a new skill for your plugin.

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 plugin skill to manage context efficiently?▼

To structure Claude plugin skills efficiently, use progressive disclosure by placing high-level summaries in SKILL.md and moving detailed information into dedicated references and assets directories to preserve context.

What writing style should I use for AI agent skill files?▼

AI agent skill files require an imperative or infinitive writing form and third-person descriptions to optimize content for AI consumption and ensure accurate trigger parsing.

What is the correct file anatomy for a Claude Code skill?▼

The anatomy of a Claude Code skill consists of a root SKILL.md file accompanied by scripts, references, and assets directories to organize triggers, logic, and supporting documentation.

How do I validate a newly created skill before deploying it as a plugin?▼

Validate a newly created skill by running it against a predefined checklist that checks for proper progressive disclosure, correct writing style, and accurate organization across SKILL.md and resource directories.

What are common mistakes when developing skills for Claude Code plugins?▼

Common mistakes when developing skills for Claude Code plugins include overloading SKILL.md with excessive detail, failing to use progressive disclosure, and applying incorrect writing styles that hinder AI comprehension.

Related Skills

Explore More Software Engineering Skills→
Reign-softwareReign-software

hytale-env-setup

Set up a Hytale plugin development environment with JDK 25 and Gradle.

Official
Intermediate
EmasoftEmasoft
4

test-skill

Automate validation testing for Claude plugins using Python tooling.

Community
Basic
Clawdi-AIClawdi-AI
4

skill-creator

Create standardized AI skill directories with SKILL.md and validation.

Official
Intermediate
rbkayzrbkayz

Skill Development

Guide authors in structuring Claude Code plugin skills with SKILL.md and validation checklists.

Community
Intermediate