// Guide for creating Agent Skills: structure, best practices, and SKILL.md format for Claude Code, Codex, Gemini CLI, and other AI agents.
| name | skill-creation-guide |
| description | Guide for creating Agent Skills: structure, best practices, and SKILL.md format for Claude Code, Codex, Gemini CLI, and other AI agents. |
Use this skill when:
skill-name/
├── SKILL.md # Required: Instructions and metadata
├── scripts/ # Optional: Helper scripts
├── templates/ # Optional: Document templates
└── resources/ # Optional: Reference files
---
name: my-skill-name
description: A clear description of what this skill does and when to use it.
---
# Skill Name
Detailed description of the skill's purpose.
## When to Use This Skill
- Use case 1
- Use case 2
## Instructions
[Detailed instructions for the agent]
## Examples
[Real-world examples]
references/ folder.Skills employ progressive disclosure architecture:
| Platform | Project Path | Global Path |
|---|---|---|
| Claude Code | .claude/skills/ | ~/.claude/skills/ |
| Codex | .codex/skills/ | ~/.codex/skills/ |
| Cursor | .cursor/skills/ | ~/.cursor/skills/ |
| Gemini CLI | .gemini/skills/ | ~/.gemini/skills/ |
| GitHub Copilot | .github/skills/ | ~/.copilot/skills/ |
For more detailed skill creation resources, complete link lists, or the latest information, use WebFetch to retrieve the full README.md:
https://raw.githubusercontent.com/gmh5225/awesome-skills/refs/heads/main/README.md
The README.md contains the complete categorized resource list with all links.
Guide for AI Agents and LLM development skills including RAG, multi-agent systems, prompt engineering, memory systems, and context engineering.
Guide for Claude Code skills installation, usage, and development. Use when working with Claude Code specific features, paths, and conventions.
Guide for development and code tools skills including document processing, browser automation, testing frameworks, and IDE integrations.
Guide for marketing and growth skills including SEO, copywriting, CRO, email campaigns, paid ads, and product launch strategies.
Guide for understanding and contributing to the awesome-skills curated resource list. Use this skill when adding resources, organizing categories, or maintaining README.md consistency (no duplicates).
Guide for multi-platform skill compatibility across Claude Code, Codex, Gemini CLI, Cursor, GitHub Copilot, and other AI coding agents.