awesome-agent-skills README

The project's README from github.com/heilcheng/awesome-agent-skills. As one markdown file: README.md.

Agent Skill Index

English | 繁體中文 | 简体中文 | 日本語 | 한국어 | Español

Agent Skill Index Banner

🌐 Browse the live directory at agent-skill.co

Maintained by Hailey Cheng (Cheng Hei Lam) · X @haileyhmt · [email protected]

Never heard of "agent skills" before? You're in the right place. This is a community-curated list of simple text files that teach AI assistants (like Claude, Copilot, or Codex) how to do new things on demand, without retraining. Unlike bulk-generated skill repositories, this collection focuses on real-world Agent Skills created and used by actual engineering teams. Compatible with Claude Code, Codex, Antigravity, Gemini CLI, Cursor, GitHub Copilot, Windsurf, and more.


Quick Start (30 seconds)

Step 1: Pick a skill from the directory below (or browse at agent-skill.co)

Step 2: Load it into your AI agent:

Step 3: Ask your AI to use it. Just describe what you want in plain English.

That's it. No installation. No configuration. No coding required.


Table of Contents


What Are Agent Skills?

Think of Agent Skills as "how-to guides" for AI assistants. Instead of the AI needing to know everything upfront, skills let it learn new abilities on the fly, like giving someone a recipe card instead of making them memorize an entire cookbook.

Skills are simple text files (called SKILL.md) that teach an AI how to do specific tasks. When you ask the AI to do something, it finds the right skill, reads the instructions, and gets to work.

How It Works

Skills load in three stages:

  1. Browse: The AI sees a list of available skills (just names and short descriptions)
  2. Load: When a skill is needed, the AI reads the full instructions
  3. Use: The AI follows the instructions and accesses any helper files

Why This Matters

Skills are instructions, not code. The AI reads them like a human would read a guide, then follows the steps.


SkillsMP Marketplace

SkillsMP Marketplace

It is recommended to use the SkillsMP Marketplace, which automatically indexes all Skill projects on GitHub and organizes them by category, update time, star count, and other tags — making it the easiest way to discover and evaluate skills.

skills.sh Leaderboard by Vercel

skills.sh Leaderboard

You can also use skills.sh — Vercel's leaderboard — to intuitively view the most popular Skills repositories and individual Skill usage statistics.

npx skills CLI Tool

For specific skills, use the npx skills command-line tool to quickly discover, add, and manage skills. For detailed parameters, see vercel-labs/skills.

npx skills find [query]            # Search for related skills
npx skills add <owner/repo>        # Install skills (supports GitHub shorthand, full URL, local path)
npx skills list                    # List installed skills
npx skills check                   # Check for available updates
npx skills update                  # Upgrade all skills
npx skills remove [skill-name]     # Uninstall skills

Compatible Agents

Agent Documentation
Claude Code code.claude.com/docs/en/skills
Claude.ai support.claude.com
Codex (OpenAI) developers.openai.com
GitHub Copilot docs.github.com
VS Code code.visualstudio.com
Antigravity antigravity.google
Kiro kiro.dev
Gemini CLI geminicli.com
Junie junie.jetbrains.com

Official Skill Directories

AI Platforms & Models

Skills by Anthropic

Official built-in skills for common document types and creative workflows.

Skills by OpenAI (Codex)

Official curated skills from OpenAI's catalog.

Skills by Google Gemini

Install via google-gemini/gemini-api-dev.

Skills by Hugging Face

Official skills for ML workflows.

Skills by Replicate

Skills by fal.ai

Skills by MiniMax

Cloud & Infrastructure

Skills by Cloudflare

Skills by Netlify

Skills by Vercel

Skills by HashiCorp (Terraform)

Skills by Neon

Skill by ClickHouse

Skills by Supabase

Skills by Tinybird


Developer Tools & Frameworks

Skills by VoltAgent

Skills by CallStack

Skills by Expo

awesome-agent-skills (heilcheng/awesome-agent-skills)

Searching Database…

What is this?A community-curated directory of 'Agent Skills' - plain-text SKILL.md files that teach AI assistants like Claude, Codex, and GitHub Copilot how to perform specific tasks on demand, without retraining.
Is this just a GitHub README, or is there an actual site to browse?It is both: the README is the curated list itself, but there is also a live directory website at agent-skill.co, plus third-party discovery tools like the SkillsMP Marketplace and the skills.sh leaderboard.
How do I actually load a skill into my AI agent?Pick a skill from the directory, then load it: in Claude Code run '/skills add', in Claude.ai paste the raw SKILL.md URL into a new conversation, and for Codex or Copilot follow the linked platform docs. No installation or configuration is needed.
Which AI agents actually support these skills?The list is built for Claude Code, Claude.ai, Codex, GitHub Copilot, VS Code, Antigravity, Kiro, Gemini CLI, and Junie, with links to each tool's own skills documentation.
Are these just mass-generated filler skills?No - the project explicitly avoids bulk-generated skill repos and focuses on real skills actually built and used by engineering teams like Cloudflare, Vercel, HashiCorp, and Hugging Face.
How is the directory organized?Skills are grouped by source and domain: official skills from Anthropic, OpenAI, Google Gemini, and Hugging Face come first, followed by category sections like Cloud & Infrastructure, Developer Tools & Frameworks, Security & Web Intelligence, and a Community Skills section.
Where should I start if I've never heard of agent skills before?Read the 'What Are Agent Skills?' section first - it explains that skills are simple SKILL.md recipe-card files an AI browses, loads, and follows in three stages (browse, load, use).
How do I find skills beyond what's listed in this README?Use the SkillsMP Marketplace to browse all GitHub skill projects by category and stars, check Vercel's skills.sh leaderboard for popularity stats, or run the npx skills CLI tool to discover and manage skills directly.
Can I write my own skill instead of just using listed ones?Yes - the README has a dedicated 'Creating Skills' section, and Anthropic's own listed 'skill-creator' skill is itself a guide for building new skills that extend Claude's capabilities.
Creator
heilcheng
Size
2.2 MB
Stars
6.3K
Updated
CommitOct 15
Age
9mo
Commits · 90 Days