From dadec22b4a3501c2b7263a644aee44ff26228ee0 Mon Sep 17 00:00:00 2001 From: xl-openai Date: Mon, 22 Dec 2025 17:44:55 -0800 Subject: [PATCH] Update README.md for skills installation instruction. (#29) --- README.md | 24 ++++++++++++++++++++---- 1 file changed, 20 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index 9e2c8e5..3e60cca 100644 --- a/README.md +++ b/README.md @@ -2,22 +2,38 @@ 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. Skills in Codex follow the open [Agent Skills specification](https://agentskills.io). +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: - [Using skills in Codex](https://developers.openai.com/codex/skills) -- [Official Agent Skills specification](https://agentskills.io) +- [Agent Skills open standard](https://agentskills.io) ## Installing a skill -Skills in the [`.system` directory](skills/.system/) directory are automatically installed in the latest version of Codex. +Skills in [`.system`](skills/.system/) are automatically installed in the latest version of Codex. -To install [curated](skills/.curated/) or [experimental](skills/.experimental/) skills, you can use the `$skill-installer` inside Codex. For example: +To install [curated](skills/.curated/) or [experimental](skills/.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.