@@ -117,7 +117,9 @@ The repository also provides reusable GitHub Actions in
 release, runs the advisory `drift` check, writes a job summary, and exposes the
 JSON report path and stale status. The `validate` Action runs strict document
 validation and exposes its JSON report path. Caller workflows under
-`.github/workflows/` are responsible for triggers and artifact uploads.
+`.github/workflows/` are responsible for triggers and artifact uploads. The
+Actions install a pinned release by default and support source mode when a
+repository workflow needs to test the checked-out CLI.
 
 ## LLM Document Contract
 
 
@@ -66,17 +66,21 @@ Repositories can run document checks in CI with the reusable GitHub Actions in
     version: 2.1.0
 ```
 
-Use `agentskill-actions/validate` for strict validation. Both Actions require a
-checked-out repository and a pinned release. The caller can upload the JSON
-report using the Action's `report-path` output; drift remains advisory, while
-validate fails when the documents are invalid.
+Use `agentskill-actions/validate` for strict validation. Release mode requires a
+checked-out repository and a pinned release; source mode uses the CLI built from
+the checked-out source. The caller can upload the JSON report using the Action's
+`report-path` output; drift remains advisory, while validate fails when the
+documents are invalid.
 
 ```yaml
 - uses: airscripts/agentskill/agentskill-actions/validate@<commit-sha>
   with:
     version: 2.1.0
 ```
 
+Repository workflows can set `source: "true"` after building the checked-out
+CLI. This skips release installation and tests the current source.
+
 ## Exit Status And Output
 
 Successful commands write JSON and exit `0`. Analyzer failures are represented