diff --git a/.codex-plugin/plugin.json b/.codex-plugin/plugin.json
new file mode 100644
index 00000000..7eb7017b
--- /dev/null
+++ b/.codex-plugin/plugin.json
@@ -0,0 +1,24 @@
+{
+  "name": "deep-research",
+  "version": "0.1.0",
+  "description": "Deep research on any topic using LLMs from Codex via MCP",
+  "author": {
+    "name": "u14app",
+    "url": "https://github.com/u14app/deep-research"
+  },
+  "homepage": "https://github.com/u14app/deep-research",
+  "repository": "https://github.com/u14app/deep-research",
+  "keywords": [
+    "mcp",
+    "codex"
+  ],
+  "mcpServers": "./.mcp.json",
+  "skills": "./skills/",
+  "interface": {
+    "displayName": "Deep Research",
+    "shortDescription": "Deep research on any topic using LLMs from Codex via MCP",
+    "longDescription": "Use any LLMs for Deep Research. Support SSE API and MCP server. Docker-based deployment.",
+    "category": "Research",
+    "websiteURL": "https://github.com/u14app/deep-research"
+  }
+}
\ No newline at end of file
diff --git a/.github/workflows/plugin-quality-gate.yml b/.github/workflows/plugin-quality-gate.yml
new file mode 100644
index 00000000..77c99c3a
--- /dev/null
+++ b/.github/workflows/plugin-quality-gate.yml
@@ -0,0 +1,20 @@
+name: Plugin Quality Gate
+
+on:
+  pull_request:
+    paths:
+      - ".codex-plugin/**"
+      - "skills/**"
+      - ".mcp.json"
+
+jobs:
+  scan:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Codex plugin quality gate
+        uses: hashgraph-online/hol-codex-plugin-scanner-action@0f78e6d99032ec198d23a41a8425080a658c07d1
+        with:
+          plugin_dir: "."
+          min_score: 80
+          fail_on_severity: high
diff --git a/.mcp.json b/.mcp.json
new file mode 100644
index 00000000..851833e0
--- /dev/null
+++ b/.mcp.json
@@ -0,0 +1,8 @@
+{
+  "mcpServers": {
+    "deep-research": {
+      "type": "http",
+      "url": "http://localhost:8000"
+    }
+  }
+}
\ No newline at end of file
diff --git a/skills/deep-research/SKILL.md b/skills/deep-research/SKILL.md
new file mode 100644
index 00000000..b4d767cc
--- /dev/null
+++ b/skills/deep-research/SKILL.md
@@ -0,0 +1,12 @@
+---
+name: deep-research
+description: Deep research on any topic using LLMs from Codex via MCP
+---
+
+# Deep Research for Codex
+
+Use Deep Research from Codex via MCP.
+
+## When to use
+- When you need deep-research capabilities in your Codex workflow
+- See https://github.com/u14app/deep-research for full setup instructions