How to Install Skills in Antigravity, Claude Code and Codex
Step-by-step: where skill folders go in Google Antigravity, Claude Code and Codex, three ways to install a skill, a full Ponytail example, and fixes for skills that do not load.
Short answer: a skill is a folder with a SKILL.md file. Put that folder in your agent's skills directory and start a new conversation. For Google Antigravity and Codex the project folder is .agents/skills/; for Claude Code it is .claude/skills/. The agent reads each skill's name and description and loads the full skill when your request matches.
Last checked against the official Antigravity, Claude Code and Codex documentation: November 2026.
Where skills go
Use the project folder to share a skill with everyone working in the repository, or the global folder to use it in every project on your machine.
| Agent | Project folder | Global folder |
|---|---|---|
| Google Antigravity (app, IDE, CLI) | <project>/.agents/skills/<skill-name>/ | ~/.gemini/config/skills/<skill-name>/ |
| Claude Code | <project>/.claude/skills/<skill-name>/ | ~/.claude/skills/<skill-name>/ |
| OpenAI Codex | <project>/.agents/skills/<skill-name>/ | ~/.agents/skills/<skill-name>/ |
Each <skill-name> folder must contain SKILL.md directly, plus any scripts, references or data files that come with the skill.
Older Antigravity paths: Antigravity still reads
.agent/skills/(singular) for backward compatibility, and the IDE also reads~/.gemini/antigravity/skills/. New installs should use the paths in the table.
Three ways to install a skill
1. Download the ZIP and copy the folder
Works for every agent and every skill on Antigravity Skills.
- Open the skill's page on Antigravity Skills and click Download.
- Unzip it. If the ZIP contains a folder, use that folder. If it contains
SKILL.mdat the top level, create a folder named after the skill (for exampleponytail) and put the files inside. - Move the folder into the skills directory from the table above, for example:
mkdir -p .agents/skills
mv ~/Downloads/ponytail .agents/skills/You should end up with .agents/skills/ponytail/SKILL.md.
2. Use the Skills CLI
The open-source skills CLI (from Vercel, not from Google, Anthropic or OpenAI) copies a skill from a GitHub repository into the right folder for your agent:
# Antigravity
npx skills add <owner>/<repo> -a antigravity
# Claude Code
npx skills add <owner>/<repo> -a claude-code
# Codex
npx skills add <owner>/<repo> -a codexAdd -g to install into the global folder instead of the current project.
3. Install the author's plugin
Some skills are also published as plugins for each agent. Plugin commands come from the skill's own install instructions, so check its README first. The Ponytail example below shows what they look like.
Worked example: installing Ponytail
Ponytail makes the agent ship the smallest correct change. Its author documents a plugin install for each agent:
Antigravity CLI
agy plugin install https://github.com/DietrichGebert/ponytailThis installs Ponytail's skills, which Antigravity also exposes as slash commands such as /ponytail-review.
Claude Code (type these in a Claude Code session)
/plugin marketplace add DietrichGebert/ponytail
/plugin install ponytail@ponytailCodex
codex plugin marketplace add DietrichGebert/ponytail
codex plugin add ponytail@ponytailThen run codex, open /hooks, review and trust Ponytail's two hooks, and start a new thread.
Any agent, skills only
npx skills add DietrichGebert/ponytailOr download it from the Ponytail page and copy the folder as in method 1.
Check that the skill loaded
| Agent | How to check |
|---|---|
| Antigravity | Start a new conversation and ask the agent to use the skill. In the app, type /<skill-name>. In the CLI, each skill is a slash command; after adding a skill mid-session, run /skills reload. In the IDE, look in the Customizations menu. |
| Claude Code | Type /<skill-name>, or describe a task that matches the skill. New or edited skills apply in the current session; run /reload-skills only if the skills folder did not exist when the session started. |
| Codex | Type /skills or $ to list skills, or describe a matching task. Codex picks up changes automatically; restart if a skill still does not appear. |
Common problems
The skill never triggers. Check that SKILL.md starts with frontmatter that includes a description. The agent decides whether to use a skill from that description, so it must say what the skill does and when to use it.
The folder is nested twice. .agents/skills/ponytail/ponytail/SKILL.md will not load. Move the inner folder up one level so the path is .agents/skills/ponytail/SKILL.md.
It worked in one agent but not another. Antigravity and Codex read .agents/skills/; Claude Code reads .claude/skills/. Copy the folder to both if you use both.
Added it mid-session. Start a new conversation, or use the reload command for your agent from the table above.
Find skills to install
- Best Antigravity Skills: 15 skills worth installing first.
- Antigravity Design & UI Skills: the design skills compared.
- All skills: the full library.