diff --git a/.github/workflows/validate-extension.yml b/.github/workflows/validate-extension.yml
new file mode 100644
index 0000000..70538fa
--- /dev/null
+++ b/.github/workflows/validate-extension.yml
@@ -0,0 +1,37 @@
+name: Validate Extension
+
+on:
+  pull_request:
+  push:
+    branches:
+      - main
+
+jobs:
+  validate-extension:
+    name: Validate extension package
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v4
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: npm
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Validate extension files
+        run: npm run validate:extension
+
+      - name: Run lint alias
+        run: npm run lint
+
+      - name: Build ZIP package
+        run: npm run zip
+
+      - name: Inspect ZIP contents
+        run: unzip -l dist/YT_Metadata_Pro_Extension.zip
diff --git a/README.md b/README.md
index 16559c9..5add62c 100644
--- a/README.md
+++ b/README.md
@@ -1,8 +1,10 @@
 <p align="center">
   <a href="https://github.com/dangercharlie/YT-Metadata-Pro"><img src="https://img.shields.io/badge/Chrome-Extension-4285F4?style=flat&logo=googlechrome&logoColor=white" alt="Chrome Extension" /></a>
   <a href="https://github.com/dangercharlie/YT-Metadata-Pro"><img src="https://img.shields.io/badge/YouTube_Data_API-v3-FF0000?style=flat&logo=youtube&logoColor=white" alt="YouTube Data API v3" /></a>
+  <a href="https://github.com/dangercharlie/YT-Metadata-Pro/releases/latest"><img src="https://img.shields.io/github/v/release/dangercharlie/YT-Metadata-Pro?style=flat&label=Release" alt="Latest release" /></a>
   <a href="https://github.com/dangercharlie/YT-Metadata-Pro"><img src="https://img.shields.io/badge/Telemetry-None-238636?style=flat" alt="Telemetry" /></a>
   <br/>
+  <a href="https://github.com/dangercharlie/YT-Metadata-Pro/actions/workflows/validate-extension.yml"><img src="https://github.com/dangercharlie/YT-Metadata-Pro/actions/workflows/validate-extension.yml/badge.svg" alt="Validate Extension workflow" /></a>
   <a href="https://github.com/dangercharlie/YT-Metadata-Pro"><img src="https://img.shields.io/badge/API_Key-Local_Only-238636?style=flat&logo=lock&logoColor=white" alt="API key stored locally" /></a>
   <a href="https://github.com/dangercharlie/YT-Metadata-Pro"><img src="https://img.shields.io/badge/Status-Manual_Tested-007EC6?style=flat" alt="Manual tested" /></a>
   <a href="https://github.com/dangercharlie/YT-Metadata-Pro"><img src="https://img.shields.io/badge/Vibe_Coded-Human_Reviewed-007EC6?style=flat" alt="Vibe coded, human reviewed" /></a>
@@ -209,6 +211,16 @@ Useful log meanings:
 
 ---
 
+## Known Limitations
+
+- Search/results pages are the tested scope for the current release.
+- YouTube can change its page structure, which may require content-script selector updates.
+- API key setup, YouTube Data API enablement, quota, or regional API behavior can affect lookup results.
+- The extension only checks YouTube's `licensedContent` metadata signal.
+- No badge means the video was not flagged by this metadata path; it does not mean the audio is safe to reuse.
+
+---
+
 ## Privacy & Security
 
 YT Metadata Pro keeps the workflow local and inspectable.