docs: clarify scoped installs and openclaw setup

integrations/README.md

@@ -21,18 +21,18 @@ supported agentic coding tools.
 # Install for all detected tools automatically
 ./scripts/install.sh
 
-# Install for a specific tool
+# Install a specific home-scoped tool
 ./scripts/install.sh --tool antigravity
 ./scripts/install.sh --tool gemini-cli
 ./scripts/install.sh --tool copilot
-./scripts/install.sh --tool opencode
 ./scripts/install.sh --tool openclaw
-./scripts/install.sh --tool cursor
-./scripts/install.sh --tool aider
-./scripts/install.sh --tool windsurf
 ./scripts/install.sh --tool claude-code
 ```
 
+For project-scoped tools such as OpenCode, Cursor, Aider, and Windsurf, run
+the installer from your target project root as shown in the tool-specific
+sections below.
+
 ## Regenerating Integration Files
 
 If you add or modify agents, regenerate all integration files:
@@ -114,6 +114,14 @@ See [opencode/README.md](opencode/README.md) for details.
 Each agent becomes an OpenClaw workspace containing `SOUL.md`, `AGENTS.md`,
 and `IDENTITY.md`.
 
+Before installing, generate the OpenClaw workspaces:
+
+```bash
+./scripts/convert.sh --tool openclaw
+```
+
+Then install them:
+
 ```bash
 ./scripts/install.sh --tool openclaw
 ```

integrations/github-copilot/README.md

@@ -1,7 +1,7 @@
 # GitHub Copilot Integration
 
-The Agency works natively with GitHub Copilot. No conversion needed — agents work
+The Agency works with GitHub Copilot out of the box. No conversion needed —
-natively with the existing `.md` + YAML frontmatter format.
+agents use the existing `.md` + YAML frontmatter format.
 
 ## Install
 

integrations/openclaw/README.md

@@ -5,6 +5,12 @@ and `IDENTITY.md` files. The installer copies each workspace into
 `~/.openclaw/agency-agents/` and registers it when the `openclaw` CLI is
 available.
 
+Before installing, generate the OpenClaw workspaces:
+
+```bash
+./scripts/convert.sh --tool openclaw
+```
+
 ## Install
 
 ```bash