diff --git a/README.md b/README.md
index ad20dda2f..67a625a1e 100644
--- a/README.md
+++ b/README.md
@@ -99,6 +99,14 @@ python scripts\validate_marketplace.py
 
 `.gitea/workflows/sync-external-skills.yml` is a scheduled workflow prototype for Git-side periodic sync.
 
+For a Docker-hosted Gitea instance, the workflow file alone is not enough. Gitea must have Actions enabled and an `act_runner` container registered before scheduled jobs will run. The runner that handles this repository should provide:
+
+- A label matching `runs-on: ubuntu-latest`, or adjust the workflow to your runner label.
+- `git`, `python`, and `pwsh` in the job environment.
+- Network access from the job container to GitHub for upstream skill repos and to the Gitea instance for checkout/push.
+
+If the Gitea server does not have Actions enabled, run the same sync command from a host cron job or a small maintenance container that checks out this repository, runs the sync script, validates, commits, and pushes changes.
+
 ## Layout
 
 ```text