Your bookmarks

Loading your bookmarks

Latest updates

New courses, skills, book chapters, and site improvements will appear here.

Create free accountSign upDashboardDashboard

Agent skill

  • Agents
  • Standard term

An agent skill is a saved, reusable set of instructions for one kind of task, with a short description that tells the agent when to use it, plus optional reference files, scripts, templates, or examples.

In systems that load skills on demand, the agent can start with a skill's name and description, then read the full instructions when selected. This keeps task-specific detail out of requests that do not need it. Selection and loading rules vary by product.

Where you’ll meet it

At the end of every month you walk your assistant through the same steps for building an expense report from your card statement. Drop the personal charges, group the rest by client, convert the euro charges to dollars, and fill in the company's template.

What to do

In Codex, invoke $skill-creator; in ChatGPT, invoke @skill-creator. Ask it to package these steps as a skill, using last month's finished report. Choose a name and a description saying when to use it. Review charge exclusions and currency conversion instructions. Next month, invoke the skill in a new chat and check the report against the new statement and company template.

Easy to mix up

A context file holds a project's standing facts and rules, read for every task. A skill holds instructions for one kind of task, and the agent loads it only when that task comes up.

Check yourself

A coworker shares a skill with careful steps for writing job postings. Its description reads only “Helpful writing tools.” You ask your agent to draft a job posting. What is likely to happen?

Go deeperSkills are plain files, which limits what they can promise

Filesystem-backed skills in Codex and Claude products use a SKILL.md file for instructions and metadata such as a name and description. Supporting files can be read as needed rather than all at once. Packaging, installation, and discovery differ by product and surface.

A skill supplies guidance, not an enforced guarantee that every step will happen. Required checks may need enforcement in the surrounding system. Skills also need maintenance when facts or tools change, and a script needs its dependencies and permissions wherever it runs.

Practice Modern AI

Or take the learning quiz on a mix of every set