diff --git a/SKILL.md b/SKILL.md
index 8e05e3bc..b6e4637c 100644
--- a/SKILL.md
+++ b/SKILL.md
@@ -23,9 +23,12 @@ PY
 Available interaction skills:
 - interaction-skills/connection.md — startup sequence, tab visibility, omnibox popup fix
 
-Available domain skills:
-- tiktok/upload.md
-- polymarket/scraping.md
+Domain skills live under `domain-skills/`. The set changes often; search it before
+site-specific work instead of trusting a short static list. Examples:
+- `github/repo-actions.md`
+- `linkedin/invitation-manager.md`
+- `polymarket/scraping.md`
+- `tiktok/upload.md`
 
 ## Tool call shape
 
diff --git a/install.md b/install.md
index 7e3b4370..385c8b23 100644
--- a/install.md
+++ b/install.md
@@ -31,6 +31,18 @@ After the repo is installed, register this repo's `SKILL.md` with the agent you
 - **Codex**: add this file as a global skill at `$CODEX_HOME/skills/browser-harness/SKILL.md` (often `~/.codex/skills/browser-harness/SKILL.md`). A symlink to this repo's `SKILL.md` is fine.
 - **Claude Code**: add an import to `~/.claude/CLAUDE.md` that points at this repo's `SKILL.md`, for example `@~/src/browser-harness/SKILL.md`.
 
+Some lazy-loading skill systems index only files literally named `SKILL.md` and
+show the agent only each skill's frontmatter until it chooses to load the full
+file. In those systems, the checked-in `domain-skills/<site>/*.md` files may
+not appear as separate skills. Register the main `SKILL.md` as usual, and make
+the session prompt explicit:
+
+```text
+Read the browser-harness SKILL.md and helpers.py first. Before any site-specific
+browser task, run `rg --files /path/to/browser-harness/domain-skills` and read
+matching site files instead of inventing the flow from scratch.
+```
+
 Codex command:
 
 ```bash