awesome-skills

# `awesome-skills`[![Awesome](https://awesome.re/badge.svg)](https://awesome.re)

[![GitHub license](https://img.shields.io/github/license/gmh5225/awesome-skills)](https://github.com/gmh5225/awesome-skills/blob/main/LICENSE)

A curated list of Agent Skills, resources, and tools for AI coding agents like Claude Code, Codex, Gemini CLI, GitHub Copilot, and more.

> Show respect to all the projects below, perfect works of art :saluting_face:

## How to contribute?
- https://github.com/HyunCafe/contribute-practice
- https://docs.github.com/en/get-started/quickstart/contributing-to-projects


## What Are Agent Skills?

**Agent Skills** are instruction files that teach AI assistants how to perform specific tasks. They are specialized folders containing instructions, scripts, and resources that AI agents dynamically discover and load when relevant to tasks.

Skills employ a **progressive disclosure architecture** for efficiency:
1. **Metadata loading** (~100 tokens): AI scans available Skills to identify relevant matches
2. **Full instructions** (<5k tokens): Load when AI determines the Skill applies
3. **Bundled resources**: Files and executable code load only as needed

### Skill Structure

```
skill-name/
├── SKILL.md          # Required: Instructions and metadata
├── scripts/          # Optional: Helper scripts
├── templates/        # Optional: Document templates
└── resources/        # Optional: Reference files
```

### Basic SKILL.md Template

```markdown
---
name: my-skill-name
description: A clear description of what this skill does.
---

# My 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 on how to execute this skill]

## Examples

[Real-world examples]
```


## Compatible Agents & Platforms

### Programming Tools

| Tool | Project Path | Global Path | Documentation |
|------|--------------|-------------|---------------|
| **Amp** | `.agents/skill