diff --git a/.github/workflows/yamllint.yaml b/.github/workflows/yamllint.yaml
new file mode 100644
index 0000000..16a78d3
--- /dev/null
+++ b/.github/workflows/yamllint.yaml
@@ -0,0 +1,15 @@
+name: yamllint
+on: [pull_request]
+jobs:
+  yamllint:
+    name: runner / yamllint
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: yamllint
+        uses: reviewdog/action-yamllint@v1.9.0
+        with:
+          reporter: github-pr-review
+          filter_mode: nofilter
+          yamllint_flags: 'apis/'
+          fail_on_error: true
diff --git a/.yamllint b/.yamllint
new file mode 100644
index 0000000..669c864
--- /dev/null
+++ b/.yamllint
@@ -0,0 +1,5 @@
+extends: default
+
+rules:
+  line-length: disable
+  document-start: disable
diff --git a/Makefile b/Makefile
index 1f16ca2..2923744 100644
--- a/Makefile
+++ b/Makefile
@@ -75,4 +75,9 @@ e2e: build controlplane.up local.xpkg.deploy.configuration.$(PROJECT_NAME) uptes
 render:
 	crossplane beta render examples/network-xr.yaml apis/basic/composition.yaml examples/function/function.yaml -r
 
-.PHONY: uptest e2e render
+yamllint:
+	@$(INFO) running yamllint
+	@yamllint ./apis || $(FAIL)
+	@$(OK) running yamllint
+
+.PHONY: uptest e2e render yamllint
diff --git a/apis/definition.yaml b/apis/definition.yaml
index 14ac502..b2b4e03 100644
--- a/apis/definition.yaml
+++ b/apis/definition.yaml
@@ -30,8 +30,8 @@ spec:
                     deletionPolicy:
                       description: Delete the external resources when the Claim/XR is deleted. Defaults to Delete
                       enum:
-                      - Delete
-                      - Orphan
+                        - Delete
+                        - Orphan
                       type: string
                       default: Delete
                     providerConfigName:
@@ -39,10 +39,10 @@ spec:
                       type: string
                       default: default
                   required:
-                  - deletionPolicy
-                  - providerConfigName
-                  - id
-                  - region
+                    - deletionPolicy
+                    - providerConfigName
+                    - id
+                    - region
                   type: object
               required:
                 - parameters