diff --git a/aqua/aqua-policy.yaml b/aqua/aqua-policy.yaml
index 5b113dfe0..912092abf 100644
--- a/aqua/aqua-policy.yaml
+++ b/aqua/aqua-policy.yaml
@@ -1,6 +1,6 @@
 ---
+# yaml-language-server: $schema=https://raw.githubusercontent.com/aquaproj/aqua/main/json-schema/policy.json
 # aqua Policy
-# https://aquaproj.github.io/docs/tutorial-extras/policy-as-code
 registries:
   - type: standard
     ref: semver(">= 3.0.0") or Version == "f9cce37273a70e2f5664fb4c3708169ffe7e320c"
diff --git a/aqua/aqua.yaml b/aqua/aqua.yaml
index bf48d928e..fc206ab79 100644
--- a/aqua/aqua.yaml
+++ b/aqua/aqua.yaml
@@ -1,4 +1,5 @@
 ---
+# yaml-language-server: $schema=https://raw.githubusercontent.com/aquaproj/aqua/main/json-schema/aqua-yaml.json
 # aqua - Declarative CLI Version Manager
 # https://aquaproj.github.io/
 checksum:
diff --git a/tests/3064/aqua.yaml b/tests/3064/aqua.yaml
index 7ee0d08f3..afe5f9699 100644
--- a/tests/3064/aqua.yaml
+++ b/tests/3064/aqua.yaml
@@ -1,4 +1,5 @@
 ---
+# yaml-language-server: $schema=https://raw.githubusercontent.com/aquaproj/aqua/main/json-schema/aqua-yaml.json
 # aqua - Declarative CLI Version Manager
 # https://aquaproj.github.io/
 checksum:
diff --git a/tests/aliases/aqua.yaml b/tests/aliases/aqua.yaml
index 7078cc949..e0184d5a9 100644
--- a/tests/aliases/aqua.yaml
+++ b/tests/aliases/aqua.yaml
@@ -1,4 +1,5 @@
 ---
+# yaml-language-server: $schema=https://raw.githubusercontent.com/aquaproj/aqua/main/json-schema/aqua-yaml.json
 # aqua - Declarative CLI Version Manager
 # https://aquaproj.github.io/
 # checksum:
diff --git a/tests/cargo/aqua.yaml b/tests/cargo/aqua.yaml
index 292ecc0c0..ce9598e4c 100644
--- a/tests/cargo/aqua.yaml
+++ b/tests/cargo/aqua.yaml
@@ -1,4 +1,5 @@
 ---
+# yaml-language-server: $schema=https://raw.githubusercontent.com/aquaproj/aqua/main/json-schema/aqua-yaml.json
 # aqua - Declarative CLI Version Manager
 # https://aquaproj.github.io/
 # checksum:
diff --git a/tests/cosign/aqua.yaml b/tests/cosign/aqua.yaml
index c8275c5f1..18a850e4e 100644
--- a/tests/cosign/aqua.yaml
+++ b/tests/cosign/aqua.yaml
@@ -1,4 +1,5 @@
 ---
+# yaml-language-server: $schema=https://raw.githubusercontent.com/aquaproj/aqua/main/json-schema/aqua-yaml.json
 # aqua - Declarative CLI Version Manager
 # https://aquaproj.github.io/
 checksum: