diff --git a/.codex-plugin/plugin.json b/.codex-plugin/plugin.json
new file mode 100644
index 00000000..0f578f77
--- /dev/null
+++ b/.codex-plugin/plugin.json
@@ -0,0 +1,29 @@
+{
+  "name": "browser-mcp",
+  "version": "0.1.0",
+  "description": "Browser automation MCP server for Codex CLI - control your browser from coding agents",
+  "author": {
+    "name": "BrowserMCP",
+    "url": "https://github.com/BrowserMCP"
+  },
+  "homepage": "https://github.com/BrowserMCP/mcp",
+  "repository": "https://github.com/BrowserMCP/mcp",
+  "license": "MIT",
+  "keywords": [
+    "mcp",
+    "browser",
+    "automation",
+    "puppeteer",
+    "web"
+  ],
+  "mcpServers": "./.mcp.json",
+  "interface": {
+    "displayName": "BrowserMCP",
+    "shortDescription": "Control your browser from Codex via MCP",
+    "longDescription": "Browser MCP is a Model Context Protocol server that allows AI applications to control your browser. Navigate pages, click elements, fill forms, take screenshots, and extract content.",
+    "developerName": "BrowserMCP",
+    "category": "Productivity",
+    "websiteURL": "https://github.com/BrowserMCP/mcp"
+  },
+  "skills": "./skills/"
+}
\ 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..c60a724a
--- /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@v1
+        with:
+          plugin_dir: "."
+          min_score: 80
+          fail_on_severity: high
diff --git a/.mcp.json b/.mcp.json
new file mode 100644
index 00000000..46e8703c
--- /dev/null
+++ b/.mcp.json
@@ -0,0 +1,11 @@
+{
+  "mcpServers": {
+    "browsermcp": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@browsermcp/mcp"
+      ]
+    }
+  }
+}
\ No newline at end of file
diff --git a/skills/browser-mcp/SKILL.md b/skills/browser-mcp/SKILL.md
new file mode 100644
index 00000000..b908f164
--- /dev/null
+++ b/skills/browser-mcp/SKILL.md
@@ -0,0 +1,22 @@
+---
+name: browser-mcp
+description: Control a real browser from Codex - navigate, click, fill forms, screenshot, and extract content via BrowserMCP.
+---
+
+# BrowserMCP for Codex
+
+Automate browser interactions through the BrowserMCP MCP server.
+
+## When to use
+
+- Testing web UIs and interactions
+- Scraping or extracting content from web pages
+- Filling out forms or automating browser workflows
+- Taking screenshots of web pages for review
+- Debugging layout or rendering issues
+
+## Tips
+
+- Use for visual verification of frontend changes
+- Combine with git operations for end-to-end testing workflows
+- The browser runs locally and requires a display or headless mode