From 0079fe2b92a1604579f84812d495c0fb7bc9ff1b Mon Sep 17 00:00:00 2001
From: Julian lechner <j.lechner@sobit.at>
Date: Thu, 17 Sep 2026 08:43:21 +0200
Subject: [PATCH] docs(ci): document and run capability checks

---
 .gitea/workflows/ci.yml |  3 +++
 README.md               | 16 ++++++++++++++++
 2 files changed, 19 insertions(+)

diff --git a/.gitea/workflows/ci.yml b/.gitea/workflows/ci.yml
index af92f17..36011b1 100644
--- a/.gitea/workflows/ci.yml
+++ b/.gitea/workflows/ci.yml
@@ -17,6 +17,8 @@ jobs:
           command -v pwsh >/dev/null || { echo 'pwsh is required on the Linux runner'; exit 1; }
       - name: Bash syntax
         run: find scripts shared/hooks -name '*.sh' -print0 | xargs -0 -n1 bash -n
+      - name: Capability checks
+        run: ./scripts/check-capabilities.sh --skip-external
       - name: Build
         run: ./scripts/build.sh --summary
       - name: Prompt budget
@@ -32,6 +34,7 @@ jobs:
         shell: pwsh
         run: |
           $env:REQUIRE_CODEX_SCHEMA = 'true'
+          ./scripts/check-capabilities.ps1 -SkipExternal
           ./scripts/build.ps1 -Summary
           ./scripts/doctor.ps1 -Summary
           ./scripts/test-shell-packages.ps1 -Summary
diff --git a/README.md b/README.md
index 9f5e456..44dc44f 100644
--- a/README.md
+++ b/README.md
@@ -11,6 +11,22 @@
 It keeps rules, skills, agents, hooks, and orchestration guidance in shared source files. Client adapters turn those files
 into shell-specific packages that can be inspected before they are installed.
 
+## Capability check
+
+Check required tools, versions, repository files, and (by default) client/network access before setup. The command exits with an error when a requirement is missing. Use `--skip-external` or `-SkipExternal` only for an offline repository-only check.
+
+PowerShell:
+
+```powershell
+.\scripts\check-capabilities.ps1
+```
+
+Bash:
+
+```bash
+./scripts/check-capabilities.sh
+```
+
 ## Quickstart
 
 With the [requirements](#requirements) installed, clone the repository, build it, then install it.