docs: clarify domain skill discovery

[Bortlesboat]

Summary

• replace the stale one-item domain-skill list in SKILL.md with guidance to search the full domain-skills/ tree
• add install guidance for lazy-loading skill systems that only index SKILL.md frontmatter
• document the session prompt workaround from Hermes Agent integration: domain-skills aren't indexable; main SKILL.md rule is lazy-loaded #155 without renaming or restructuring the checked-in domain skills

Validation

• git diff --check
• verified referenced files exist: domain-skills/github/repo-actions.md, domain-skills/linkedin/invitation-manager.md, domain-skills/tiktok/upload.md, SKILL.md, helpers.py

---

Summary by cubic

Clarifies how to find domain skills by replacing the stale list in SKILL.md with guidance to search the domain-skills/ directory and example paths. Adds install guidance for lazy-loading skill systems, including a session prompt so agents load matching site files instead of inventing flows.

^{Written for commit 4358ecd. Summary will update on new commits.}

[browser-harness-review]

✅ Skill review passed

Reviewed 1 file(s) — no findings.

[cubic-dev-ai]

1 issue found across 2 files

Prompt for AI agents (unresolved issues)

Check if these issues are valid — if so, understand the root cause of each and fix them. If appropriate, use sub-agents to investigate and fix each issue separately.


<file name="install.md">

<violation number="1" location="install.md:42">
P2: Shell command uses angle-bracket placeholder (`<browser-harness>`) that is parsed as redirection, causing literal execution failures.</violation>
</file>

_{Reply with feedback, questions, or to request a fix. Tag @cubic-dev-ai to re-run a review, or fix all with cubic.}

[cubic-dev-ai]

P2: Shell command uses angle-bracket placeholder (<browser-harness>) that is parsed as redirection, causing literal execution failures.

Prompt for AI agents

Check if this issue is valid — if so, understand the root cause and fix it. At install.md, line 42:

<comment>Shell command uses angle-bracket placeholder (`<browser-harness>`) that is parsed as redirection, causing literal execution failures.</comment>

<file context>
@@ -31,6 +31,18 @@ After the repo is installed, register this repo's `SKILL.md` with the agent you
+
+```text
+Read the browser-harness SKILL.md and helpers.py first. Before any site-specific
+browser task, run `rg --files <browser-harness>/domain-skills` and read matching
+site files instead of inventing the flow from scratch.
+```
</file context>

Suggested change

	browser task, run `rg --files <browser-harness>/domain-skills` and read matching
	browser task, run `rg --files /path/to/browser-harness/domain-skills` and read matching