From 88a088f3110909954cac7bf20302c551c11d3849 Mon Sep 17 00:00:00 2001 From: Bortlesboat Date: Thu, 23 Apr 2026 00:03:37 -0400 Subject: [PATCH 1/2] docs: clarify domain skill discovery --- SKILL.md | 9 ++++++--- install.md | 12 ++++++++++++ 2 files changed, 18 insertions(+), 3 deletions(-) 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..9be014cf 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//*.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 /domain-skills` and read matching +site files instead of inventing the flow from scratch. +``` + Codex command: ```bash From 980490ae270eadf2d8d279edf56c8fbf2a376691 Mon Sep 17 00:00:00 2001 From: Bortlesboat Date: Tue, 28 Apr 2026 02:14:02 -0400 Subject: [PATCH 2/2] docs: avoid angle-bracket shell placeholder --- install.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/install.md b/install.md index 9be014cf..385c8b23 100644 --- a/install.md +++ b/install.md @@ -39,8 +39,8 @@ the session prompt explicit: ```text Read the browser-harness SKILL.md and helpers.py first. Before any site-specific -browser task, run `rg --files /domain-skills` and read matching -site files instead of inventing the flow from scratch. +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: