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 skillsWhat 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.mdSKILL.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
- SKILL.md: the fields, the rules each one follows, and the instructions below them.
- The skill folder: what else a skill can hold, where it goes, and how to zip it for an upload.
- How agents differ: how Claude Code, the Claude apps, Codex, VS Code, Copilot and others read the same skill.
- Checks and tools: what qai.io/skills checks on every listed skill, and the tools that check your own.
- A page for each agent, with where it looks for skills, how to install one and what to watch for:
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.