fix: resolve linting script issues in CI

- Rename malformed validate-docs script (Scripts/"?|.sh -> Scripts/validate-docs.sh)
- Fix bash syntax error: remove invalid 'local' declaration outside function
- Improve Linux compatibility: replace readlink -f with portable alternative
- Disable build jobs temporarily to speed up linting CI validation

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

Author: leogdion

.github/workflows/SyntaxKit.yml

@@ -10,7 +10,7 @@ jobs:
     name: Build on Ubuntu
     runs-on: ubuntu-latest
     container: ${{ matrix.swift.nightly && format('swiftlang/swift:nightly-{0}-{1}', matrix.swift.version, matrix.os) || format('swift:{0}-{1}', matrix.swift.version, matrix.os) }}
-    if: ${{ !contains(github.event.head_commit.message, 'ci skip') }}
+    if: false
     strategy:
       matrix:
         os: [noble, jammy]
@@ -41,7 +41,7 @@ jobs:
     env:
       PACKAGE_NAME: SyntaxKit
     runs-on: ${{ matrix.runs-on }}
-    if: "!contains(github.event.head_commit.message, 'ci skip')"
+    if: false
     strategy:
       fail-fast: false
       matrix:
@@ -125,7 +125,6 @@ jobs:
     name: Linting
     if: "!contains(github.event.head_commit.message, 'ci skip')"  
     runs-on: ubuntu-latest
-    needs: [build-ubuntu, build-macos]
     env:
       MINT_PATH: .mint/lib
       MINT_LINK_PATH: .mint/bin

Scripts/lint.sh

@@ -21,7 +21,7 @@ echo "LintMode: $LINT_MODE"
 
 # More portable way to get script directory
 if [ -z "$SRCROOT" ]; then
-    SCRIPT_DIR=$(dirname "$(readlink -f "$0")")
+    SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
     PACKAGE_DIR="${SCRIPT_DIR}/.."
 else
     PACKAGE_DIR="${SRCROOT}"
@@ -86,7 +86,7 @@ if [ -z "$SKIP_DOCS" ]; then
 
 	# DocC generation with warnings as errors
 	echo "Generating DocC documentation (warnings as errors)..."
-	local docc_output=$(mktemp)
+	docc_output=$(mktemp)
 	if ! swift package generate-documentation --warnings-as-errors 2>"$docc_output"; then
 		echo "❌ DocC generation failed due to warnings or errors"
 		echo "🔍 Error details:"

Scripts/"?|.sh Scripts/validate-docs.shScripts/"?|.sh renamed to Scripts/validate-docs.sh

@@ -17,7 +17,7 @@ echo "════════════════════════
 
 # More portable way to get script directory
 if [ -z "$SRCROOT" ]; then
-    SCRIPT_DIR=$(dirname "$(readlink -f "$0")")
+    SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
     PACKAGE_DIR="${SCRIPT_DIR}/.."
 else
     PACKAGE_DIR="${SRCROOT}"     
@@ -217,7 +217,7 @@ validate_api_coverage() {
 
     # More portable way to get script directory
     if [ -z "$SRCROOT" ]; then
-        SCRIPT_DIR=$(dirname "$(readlink -f "$0")")
+        SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
         PACKAGE_DIR="${SCRIPT_DIR}/.."
     else
         PACKAGE_DIR="${SRCROOT}"