@@ -30,6 +30,7 @@ Script helper to install Codex skills into `~/.agents/skills`.
3030- Recognizes skill folders by ` SKILL.md ` .
3131- Keeps installs idempotent across repeated runs.
3232- Avoids overwriting skills that belong to a different source.
33+ - Supports removing one installed skill by its visible Codex skill name.
3334- Removes stale skills only for the same source.
3435
3536## Requirements
@@ -42,6 +43,7 @@ Script helper to install Codex skills into `~/.agents/skills`.
4243
4344``` bash
4445./install-skills.sh [options] [source] [destination_dir]
46+ ./install-skills.sh --remove-skill < skill_name> [destination_dir]
4547```
4648
4749### Source
@@ -59,6 +61,11 @@ Script helper to install Codex skills into `~/.agents/skills`.
5961### Options
6062
6163- ` -h ` , ` --help ` : Show help.
64+ - ` --remove-skill <skill_name> ` : Remove one installed skill from the destination.
65+ You can pass either:
66+ - the skill ` name: ` from ` SKILL.md ` , which is the name Codex shows in VS Code
67+ and uses for routing
68+ - the installed skill folder name under ` ~/.agents/skills `
6269
6370## Examples
6471
@@ -77,10 +84,24 @@ Script helper to install Codex skills into `~/.agents/skills`.
7784
7885# Install from GitHub nested skills folder to custom destination
7986./install-skills.sh " https://github.com/openai/skills/tree/main/skills" " ~/.agents/skills"
87+
88+ # Remove an installed skill by the same name shown in Codex chat
89+ ./install-skills.sh --remove-skill nebius
90+
91+ # Remove an installed skill by its folder name
92+ ./install-skills.sh --remove-skill vendor-nebius
8093```
8194
8295## Notes
8396
8497- Existing unmanaged folders in destination are never overwritten.
8598- If a skill exists but belongs to another source, it is skipped.
8699- A valid skill folder must contain ` SKILL.md ` .
100+ - ` --remove-skill ` deletes the matching skill folder from the destination and
101+ removes its local manifest entries.
102+ - After removing a skill, reload the VS Code extension host to refresh skill
103+ discovery.
104+ - Reinstalling from a source that still contains the skill will add it back.
105+ - The installer uses ` rsync --delete ` inside each managed skill directory, and
106+ it also removes stale skills that were previously installed from the same
107+ source.
0 commit comments