creating-agent-skills

Guide creation of well-structured Agent Skills with SKILL.md best practices.

Updated Mar 7, 2026

Search Tags:#skill development #best practices #documentation #AI development #agent skills

Ready to run

npx skills add https://github.com/mazrean/agent-skills --skill creating-agent-skills-mazrean

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: creating-agent-skills
Source: https://github.com/mazrean/agent-skills/tree/main/skills/creating-agent-skills
Command: npx skills add https://github.com/mazrean/agent-skills --skill creating-agent-skills-mazrean

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a structured framework and best practices for creating, organizing, and documenting AI Skills, ensuring they are discoverable, maintainable, and effective.

Core Features & Use Cases

Skill Structure Guidance: Learn the optimal directory layout and file organization for Agent Skills.
SKILL.md Best Practices: Understand how to write effective name, description, and instructional content.
Progressive Disclosure: Implement patterns to keep skills concise and load context efficiently.
Use Case: You're starting a new project and need to build several custom AI skills. Use this Skill to ensure all your new skills follow a consistent, high-quality standard from the outset.

Quick Start

Create a new skill directory with a basic SKILL.md file.

Frequently Asked Questions about creating-agent-skills

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

What's the best way to structure an AI agent skill for discoverability?▼

To create AI agent skills, you need a structured directory layout and a well-defined SKILL.md file. This framework provides best practices for skill development, ensuring your new skills are discoverable and maintainable from the outset.

How do I write a SKILL.md file for an AI skill?▼

Writing a SKILL.md file requires defining effective `name`, `description`, and instructional content. Following documentation best practices ensures your AI skill is maintainable and operates efficiently on AI platforms.

What is progressive disclosure in AI skill development?▼

Progressive disclosure in AI skill development is a pattern that keeps skills concise by loading context efficiently. It prevents overwhelming the agent by only providing detailed instructions and references when needed during a task.

How do I organize directories for a custom AI skill?▼

Organizing directories for a custom AI skill involves adopting an optimal file structure that separates core logic from references. This structured framework ensures your skill remains maintainable and effective as your project scales.

Can I improve an existing AI skill's documentation and structure?▼

Yes, you can improve existing AI skills by applying these best practices for directory organization and SKILL.md content. Refining documentation and implementing progressive disclosure patterns enhances operational efficiency and discoverability.