docs: worktree + submodule support, project vs user-level paths

SKILL.md now checks project-level (.claude/skills/) first, then
user-level (~/.claude/skills/). Auto-detects uninitialized submodules
and runs git submodule update --init. README explains worktree behavior.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
Garry Tan
2026-03-11 16:01:08 -07:00
parent 8499173120
commit 16a2fb1abe
2 changed files with 28 additions and 9 deletions
+6 -2
View File
@@ -120,23 +120,27 @@ The browser **persists between calls**. Navigate once, then query as many times
## Install
Just clone it. Claude handles the rest on first use (installs dependencies, compiles the binary).
Just clone it. Claude handles the rest on first use (installs dependencies, compiles the binary, ~10 seconds).
### Option A: Project-level (recommended for teams)
Run this from the root of your git project:
```bash
git submodule add https://github.com/garrytan/gstack-browse.git .claude/skills/gstack-browse
```
Commit the submodule. Everyone who clones your repo gets the browser.
**Worktrees**: New worktrees need `git submodule update --init .claude/skills/gstack-browse` to populate the directory. Claude's auto-setup handles this — it detects an empty submodule and runs the init for you.
### Option B: User-level (personal)
```bash
git clone https://github.com/garrytan/gstack-browse.git ~/.claude/skills/gstack-browse
```
That's it. Next time Claude needs to browse a page, it'll detect the skill, ask to run setup (~10 seconds), and you're live.
Available across all your projects. No per-repo setup.
**Prerequisite**: [Bun](https://bun.sh/) v1.0+ (Claude will tell you if it's missing).