AI Agent Skills for Claude Code, Cursor and Codex
An agent skill is a folder of instructions a coding agent loads when a task needs it: a SKILL.md file with a name, a description and Markdown steps, sometimes with scripts beside it. Claude Code reads skills from .claude/skills/, Cursor uses them as rules in .cursor/rules/, and Codex finds them through AGENTS.md.
Most installed skills
Public skills ranked by how many times they have been installed. Each one names its author and version.
No public skills yet
When an author makes a skill public, it shows up here. Publish your own with deftro publish and set its visibility to public.
Open DiscoverInstall in one command
Run it in the root of your project. Replace <handle>/<slug> with the name shown on any skill's page.
- Claude Code
.claude/skills/<slug>/SKILL.md - Cursor
.cursor/rules/<slug>.mdc - Antigravity
.agents/skills/<slug>/SKILL.md - Codex and other AGENTS.md readers
AGENTS.md → .agents/skills/<slug>/
The CLI writes to every agent folder it finds in the project (.claude, .cursor, .agents, .codex), and to .agents/skills/ when it finds none. Pick one with --agent claude.
Guides
What are agent skills?
What an agent skill is, what goes in a SKILL.md, and how Claude Code, Cursor, Codex and Antigravity load them. With examples you can install.Install Claude Code skills
Where Claude Code looks for skills, how to install one with a single command, and how to keep a team on the same reviewed version.Cursor rules
How .cursor/rules and .mdc files work, how they differ from the old .cursorrules and AGENTS.md, and how to share one set of rules across a team.Skills vs MCP
Skills are instructions an agent reads; MCP servers are tools it calls. When to use each, and how they work together in Claude Code and Cursor.Reviewing agent skills
A skill runs with your agent's access. What can go wrong, what to read before installing one, and how a team reviews each version first.
Questions
What is an agent skill?
A SKILL.md file, with optional files beside it, that tells a coding agent how to do one job: write release notes, review a migration, follow your API conventions. The agent reads the short description first and loads the full instructions when a task matches it.
Where do skills live on disk?
In the project, next to your code. Claude Code reads .claude/skills/<slug>/SKILL.md, and personal skills from ~/.claude/skills/. Deftro writes the Cursor version to .cursor/rules/<slug>.mdc and the Antigravity version to .agents/skills/<slug>/SKILL.md. For Codex it adds a line to AGENTS.md that points at .agents/skills/<slug>/.
How do I install a skill from Deftro?
Run npx @deftro/cli install <handle>/<slug> in the project root. The CLI writes the skill for every agent folder it finds there and records the version in bv.lock. Add @<version> to the name to pin a version, or --agent claude to write for one agent only.
How does a team review a skill before using it?
In an organisation vault, a new version waits until an admin or project lead reviews it. The reviewer sees a diff against the last approved version and the health check notes, then approves or requests changes. Approved versions cannot change, and every decision is recorded in Activity.
Do skills work in Codex?
Codex reads AGENTS.md. When the project has a .codex folder, the CLI copies the skill to .agents/skills/<slug>/ and adds a one-line pointer to a managed block in AGENTS.md, so Codex knows the skill exists and where to read it.