diff --git a/.github/workflows/build-release.yml b/.github/workflows/build-release.yml
index 43a254b..659f009 100644
--- a/.github/workflows/build-release.yml
+++ b/.github/workflows/build-release.yml
@@ -168,6 +168,13 @@ jobs:
           # Upload skill-menu.json (used by the wizard to discover available skills)
           echo "Uploading skill-menu.json..."
           gh release upload "$RELEASE_TAG" dist/skills/skill-menu.json --clobber
+          # Upload reference docs (used by the wizard for runtime-specific overrides)
+          for file in dist/skills/*.md; do
+            [ -f "$file" ] || continue
+            filename=$(basename "$file")
+            echo "Uploading $filename..."
+            gh release upload "$RELEASE_TAG" "$file" --clobber
+          done
 
       - name: Update latest tag
         env:
diff --git a/scripts/build.js b/scripts/build.js
index d4e6b4a..a618c1a 100755
--- a/scripts/build.js
+++ b/scripts/build.js
@@ -250,6 +250,20 @@ async function main() {
         fs.writeFileSync(skillMenuPath, JSON.stringify(skillMenu, null, 2));
         console.log(`  ✓ skill-menu.json (${Object.keys(skillsByCategory).length} categories, ${skills.length} skills)`);
 
+        // Write fetched docs marked as release_asset to skills dir (uploaded as release assets)
+        const releaseAssetDocs = docEntries.filter(d => d.release_asset);
+        if (releaseAssetDocs.length > 0) {
+            console.log('\nWriting release-asset docs...');
+            for (const doc of releaseAssetDocs) {
+                const content = docContents[doc.id];
+                if (content) {
+                    const filename = `${doc.id}.md`;
+                    fs.writeFileSync(path.join(skillsDir, filename), content);
+                    console.log(`  ✓ ${filename} (${content.length} chars)`);
+                }
+            }
+        }
+
         // Create bundled archive
         console.log('\nCreating bundled archive...');
         const bundlePath = path.join(distDir, 'skills-mcp-resources.zip');
diff --git a/transformation-config/docs.yaml b/transformation-config/docs.yaml
index e3818c8..1ca6752 100644
--- a/transformation-config/docs.yaml
+++ b/transformation-config/docs.yaml
@@ -8,3 +8,11 @@ docs:
     tags: [core, users, identity]
     urls:
       - https://posthog.com/docs/getting-started/identify-users.md
+
+  - id: cloudflare-workers
+    display_name: Cloudflare Workers
+    description: Runtime-specific overrides for PostHog on Cloudflare Workers (env access, event flushing, Node.js compat)
+    tags: [runtime, cloudflare, workers, edge]
+    release_asset: true  # Also write as standalone .md for wizard to fetch directly
+    urls:
+      - https://posthog.com/docs/libraries/cloudflare-workers.md