creating-agent-skills

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

Updated Mar 7, 2026
One-click install
npx skills add https://github.com/mazrean/agent-skills --skill creating-agent-skills-mazrean
Or copy as Structured Prompt for Agent
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.