diff --git a/packages/types/src/__tests__/roomodes-schema.spec.ts b/packages/types/src/__tests__/roomodes-schema.spec.ts
index f3530a225d2..128fc26987f 100644
--- a/packages/types/src/__tests__/roomodes-schema.spec.ts
+++ b/packages/types/src/__tests__/roomodes-schema.spec.ts
@@ -28,6 +28,10 @@ describe("roomodes JSON schema", () => {
 		expect(validate).toBeDefined()
 	})
 
+	it("should advertise a JSON-serving canonical $id", () => {
+		expect(schema["$id"]).toBe("https://raw.githubusercontent.com/RooCodeInc/Roo-Code/main/schemas/roomodes.json")
+	})
+
 	it("should accept a minimal valid .roomodes config", () => {
 		const config = {
 			customModes: [
diff --git a/packages/types/src/roomodes-schema.ts b/packages/types/src/roomodes-schema.ts
index 62833956867..54e2ef7833b 100644
--- a/packages/types/src/roomodes-schema.ts
+++ b/packages/types/src/roomodes-schema.ts
@@ -50,7 +50,7 @@ export function generateRoomodesJsonSchema(): Record<string, unknown> {
 		target: "jsonSchema7",
 	}) as Record<string, unknown>
 
-	jsonSchema["$id"] = "https://github.com/RooCodeInc/Roo-Code/blob/main/schemas/roomodes.json"
+	jsonSchema["$id"] = "https://raw.githubusercontent.com/RooCodeInc/Roo-Code/main/schemas/roomodes.json"
 	jsonSchema["title"] = "Roo Code Custom Modes"
 	jsonSchema["description"] = "Schema for .roomodes configuration files used by Roo Code to define custom modes."
 
diff --git a/schemas/roomodes.json b/schemas/roomodes.json
index 2b4349afcbc..233dd9f8346 100644
--- a/schemas/roomodes.json
+++ b/schemas/roomodes.json
@@ -90,7 +90,7 @@
 	"required": ["customModes"],
 	"additionalProperties": false,
 	"$schema": "http://json-schema.org/draft-07/schema#",
-	"$id": "https://github.com/RooCodeInc/Roo-Code/blob/main/schemas/roomodes.json",
+	"$id": "https://raw.githubusercontent.com/RooCodeInc/Roo-Code/main/schemas/roomodes.json",
 	"title": "Roo Code Custom Modes",
 	"description": "Schema for .roomodes configuration files used by Roo Code to define custom modes."
 }