diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..0b4c9aa
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,14 @@
+# AGENTS.md
+
+## Skills
+
+A skill is a set of local instructions stored in a `SKILL.md` file.
+
+### Available skills
+
+- react-devtools: React DevTools CLI for AI agents. Use when debugging a React or React Native app at runtime, inspecting component props/state/hooks, diagnosing re-renders, or profiling performance. (file: `packages/agent-react-devtools/skills/react-devtools/SKILL.md`)
+
+### How to use skills
+
+- Trigger rule: Use `react-devtools` when the task is React runtime debugging or performance analysis.
+- Invocation: Read `packages/agent-react-devtools/skills/react-devtools/SKILL.md` and follow its core workflow and command guidance.
diff --git a/README.md b/README.md
index 8541636..356f62d 100644
--- a/README.md
+++ b/README.md
@@ -226,9 +226,15 @@ You can also install via the Claude Code plugin marketplace:
 /plugin install agent-react-devtools@piotrski
 ```
 
+### Codex
+
+Codex discovers project skills from `AGENTS.md`. This repo includes one at the root that registers:
+
+- `packages/agent-react-devtools/skills/react-devtools/SKILL.md`
+
 ### Manual setup
 
-Alternatively, add something like this to your project's `CLAUDE.md` (or equivalent agent instructions):
+If your assistant does not auto-load skills, add something like this to your project's `AGENTS.md`, `CLAUDE.md`, or equivalent agent instructions:
 
 ```markdown
 ## React Debugging