diff --git a/.codex-plugin/plugin.json b/.codex-plugin/plugin.json
new file mode 100644
index 0000000..3723ce6
--- /dev/null
+++ b/.codex-plugin/plugin.json
@@ -0,0 +1,23 @@
+{
+    "name": "kotlin-agent-skills",
+    "version": "1.0.0",
+    "description": "AI agent skills for Kotlin projects.",
+    "author": {
+        "name": "Kotlin",
+        "url": "https://kotlinlang.org/"
+    },
+    "homepage": "https://github.com/Kotlin/kotlin-agent-skills",
+    "repository": "https://github.com/Kotlin/kotlin-agent-skills",
+    "license": "Apache-2.0",
+    "keywords": ["kotlin"],
+    "interface": {
+        "displayName": "Kotlin skills for agents",
+        "shortDescription": "Reusable skills for software development using Kotlin.",
+        "longDescription": "Reusable skills for software development using Kotlin.",
+        "developerName": "JetBrains",
+        "category": "Productivity",
+        "capabilities": ["Read", "Write"],
+        "websiteURL": "https://kotlinlang.org/"
+    },
+    "skills": "./skills"
+}
diff --git a/README.md b/README.md
index 886d877..e336745 100644
--- a/README.md
+++ b/README.md
@@ -45,6 +45,15 @@ See [npx skills](https://github.com/vercel-labs/skills) for more options.
 /plugin install kotlin-agent-skills@Kotlin
 ```
 
+### Codex
+
+In shell:
+```shell
+codex plugin marketplace add Kotlin/kotlin-agent-skills
+```
+
+Then inside `codex` invoke `/plugins`, search for `kotlin-agent-skills`, press 'Enter' and select 'Install plugin'.
+
 ### Manual installation
 
 Copy the desired skill folder from [skills](./skills) into the skills directory of your agent, for example: