diff --git a/tech_writer.yml b/tech_writer.yml
index 386046a0c7..4b26745823 100644
--- a/tech_writer.yml
+++ b/tech_writer.yml
@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/docker/cagent/refs/heads/main/cagent-schema.json
 agents:
   root:
     model: sonnet