diff --git a/.github/workflows/developer-docs.yaml b/.github/workflows/developer-docs.yaml
new file mode 100644
index 00000000..00af1f13
--- /dev/null
+++ b/.github/workflows/developer-docs.yaml
@@ -0,0 +1,33 @@
+name: Developer Docs
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - 'developer-docs/**'
+      - '.github/workflows/developer-docs.yaml'
+  pull_request:
+    paths:
+      - 'developer-docs/**'
+      - '.github/workflows/developer-docs.yaml'
+
+permissions:
+  contents: read
+
+jobs:
+  validate:
+    name: Validate OKF bundle
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+
+      - name: Validate developer-docs
+        uses: galkleinman/okf-toolkit@c7c29e678f37c990fb0b04ca08411bb2e5bdf3bf # v0.2.1
+        with:
+          path: developer-docs
+          command: validate
diff --git a/developer-docs/index.md b/developer-docs/index.md
index 7575c44c..6613cf13 100644
--- a/developer-docs/index.md
+++ b/developer-docs/index.md
@@ -1,10 +1,5 @@
 ---
-type: Index
-title: developer-docs
-description: OKF knowledge bundle entry point for firebaseui-web.
-tags: [okf, documentation]
 okf_version: "0.1"
-timestamp: 2026-07-03T00:00:00Z
 ---
 
 # developer-docs