Agent Skills

A skill is a folder with a SKILL.md file in it: instructions an AI coding agent loads when a task calls for them, and sometimes the scripts and files those instructions use.

Find a skill on qai.io/skillsSkills from public repositories, each read at an exact commit, with what it can touch and what our check flagged.Browse skills

What a skill is

A skill teaches an agent one job, such as filling in a PDF form or reviewing a pull request. Its folder holds a SKILL.md and, when the job needs them, scripts the agent can run and longer documents it can read.

pdf-forms/
├── SKILL.md
├── scripts/
│   └── fill_form.py
└── references/
    └── field-types.md

SKILL.md opens with a few fields between two lines of three hyphens. Two are required: a name, the same as the folder’s, and a description that says what the skill does and when to use it. The instructions follow, in Markdown.

---
name: pdf-forms
description: Fill in PDF forms. Use when a PDF has fields to complete.
---

# Fill in PDF forms

1. List the form's fields: python scripts/fill_form.py --list form.pdf
2. Ask which values to use for any field you can't fill from the request.
3. For checkbox and date fields, see references/field-types.md.

How an agent uses a skill

An agent keeps a list of every installed skill’s name and description, and picks a skill when your request matches one. The description is what gets a skill picked, so it should say when to use it as well as what it does. Once a skill is picked, the agent reads its instructions and the files they point to.

Without a description, Codex skips a skill, and Claude Code falls back to the first line of its instructions. Each agent reads the format a little differently: How agents differ sets out where.


Where skills live

An agent reads skills from folders of its own: one inside a project, for that project only, and one in your home folder, for all your projects. Claude Code reads .claude/skills, Codex and most other agents read .agents/skills, and GitHub Copilot and VS Code also read .github/skills. The Claude apps keep skills in your account instead, uploaded as a zip.

Agents has the folders for every agent we list, and how to install a skill there.


In this section


Check yours

Validate a SKILL.md shows what each agent will reject in your file, with the fix. It runs in your browser, and anyone can use it.