diff --git a/.github/workflows/lint.yml b/.github/workflows/lint.yml
index b82423a..aff3c94 100755
--- a/.github/workflows/lint.yml
+++ b/.github/workflows/lint.yml
@@ -47,54 +47,43 @@ jobs:
                #        fail_on_error: true
                #        files: .
 
-               - name: Install and run Vale
+               - name: Install and run Vale (direct)
                  run: |
                       # Install Vale (same binary the action uses)
                       wget -qO- https://github.com/errata-ai/vale/releases/download/v3.14.1/vale_3.14.1_Linux_64-bit.tar.gz | tar xz -C /tmp
                       export PATH="/tmp:$PATH"
 
-                      # Ensure we are in the repository root
-                      echo "=== PWD ==="
-                      pwd
+                      # sanity
+                      echo "=== PWD ==="; pwd
 
-                      # Show .vale.ini so we can confirm patterns / BasedOnStyles
-                      echo ""
-                      echo "=== .vale.ini ==="
-                      sed -n '1,200p' .vale.ini || echo "No .vale.ini found"
+                      # show config
+                      echo "=== .vale.ini ==="; sed -n '1,200p' .vale.ini || echo "No .vale.ini found"
 
-                      # Confirm markdown files exist
-                      echo ""
-                      echo "=== Markdown files (first 50) ==="
-                      find content -name '*.md' -print | sed -n '1,50p' || true
+                      # list markdown files
+                      echo "=== Markdown files (first 100) ==="
+                      find content -name '*.md' -print | sed -n '1,100p' || true
 
-                      # Sync packages into StylesPath (.vale)
-                      echo ""
-                      echo "=== vale sync ==="
-                      vale sync
+                      # sync packages into StylesPath
+                      echo "=== vale sync ==="; vale sync
 
-                      # List installed style/package files so we can confirm rules are present
-                      echo ""
-                      echo "=== .vale contents ==="
-                      ls -la .vale || true
-                      find .vale -type f -maxdepth 5 -print | sed -n '1,200p' || true
+                      # list installed style files
+                      echo "=== .vale contents ==="; ls -la .vale || true
+                      find .vale -type f -maxdepth 6 -print | sed -n '1,200p' || true
 
-                      # Vale binary version & debug on one known file (shows which config and styles were loaded)
-                      echo ""
-                      echo "=== vale --version & debug ==="
+                      # show vale version and debug one known file (reveals loaded config, styles, rules)
+                      echo "=== vale --version & debug content/index.md ==="
                       vale --version
                       vale --debug content/index.md || true
 
-                      # Lint each markdown file individually and print JSON + line output so nothing is filtered
-                      echo ""
-                      echo "=== Linting files one-by-one (JSON then line) ==="
+                      # lint each markdown file one-by-one so nothing is filtered
+                      echo "=== Per-file JSON + line output ==="
                       find content -name '*.md' -print0 | xargs -0 -n1 -I{} sh -c '
                            echo "----- {} -----";
                            vale --output=JSON "{}" || true;
                            vale --output=line "{}" || true;
                       '
 
-                      # Also run a recursive lint in case you prefer aggregated output
-                      echo ""
+                      # also run aggregated recursive run as a final check
                       echo "=== Recursive run (all content) ==="
                       vale --output=JSON content/ || true
                       vale --output=line content/ || true