skills README

The project's README from github.com/openai/skills. As one markdown file: README.md.

[!IMPORTANT] This repository is deprecated. For current Codex skill and plugin examples, use the OpenAI Plugins repository. If you want to add your own skills to Codex, follow the Build plugins guide, which includes instructions for creating a skill-only plugin.

Agent Skills

Agent Skills are folders of instructions, scripts, and resources that AI agents can discover and use to perform at specific tasks. Write once, use everywhere.

Codex uses skills to help package capabilities that teams and individuals can use to complete specific tasks in a repeatable way. This repository catalogs skills for use and distribution with Codex.

Learn more:

Installing a skill

Skills in .system are automatically installed in the latest version of Codex.

To install curated or experimental skills, you can use the $skill-installer inside Codex.

Curated skills can be installed by name (defaults to skills/.curated):

$skill-installer gh-address-comments

For experimental skills, specify the skill folder. For example:

$skill-installer install the create-plan skill from the .experimental folder

Or provide the GitHub directory URL:

$skill-installer install https://github.com/openai/skills/tree/main/skills/.experimental/create-plan

After installing a skill, restart Codex to pick up new skills.

License

The license of an individual skill can be found directly inside the skill's directory inside the LICENSE.txt file.

skills (openai/skills)

Searching Database…

28.1K ·GitHub
What is this?A catalog of Agent Skills for Codex: folders of instructions, scripts, and resources that the AI agent can discover and use to perform specific tasks in a repeatable way.
So it's not an app I install — what am I actually getting?A repository of skill folders that Codex discovers at runtime. A skill is written once and reused everywhere the agent runs, so the repo itself has nothing to execute.
How do I install a skill into Codex?Skills under .system come preinstalled in the latest Codex. For curated or experimental ones, use the $skill-installer inside Codex — by name, folder path, or GitHub directory URL — then restart Codex.
I saw a deprecation notice — is this repo still usable?It's deprecated: OpenAI moved current skill and plugin examples to the OpenAI Plugins repository, and authors of new skills are pointed to the Build plugins guide instead.
Do all skills share one license?No — there is no single repo license. Each skill carries its own, stored in a LICENSE.txt file inside that skill's directory.
What's the difference between system, curated, and experimental skills?System skills ship automatically with the latest Codex. Curated skills are stable enough to install just by name, while experimental ones need their specific skill folder or a GitHub directory URL.
Can I write my own skill for Codex?Yes — the README points to the Build plugins guide, which includes instructions for creating a skill-only plugin. For current examples, the OpenAI Plugins repository has replaced this catalog.
Creator
openai
Size
2.5 MB
Stars
28.1K
Updated
CommitJun 24
Age
10mo
Commits · 90 Days