lobsterlink-tab-share

Name: lobsterlink-tab-share
Author: davidguttman

32stars5forks

How to install lobsterlink-tab-share?

davidguttman/lobsterlink/lobsterlink-tab-share

$npx -y skills add davidguttman/lobsterlink --skill lobsterlink-tab-share

Installs into the current project.

Summary

Use when a human wants to share a logged-in tab from the isolated OpenClaw browser so the agent can work through LobsterLink in that authenticated session. Triggers include requests to share a tab, give a LobsterLink peer/share ID, use a logged-in tab, or host/stop hosting a tab

Files · 1

View on GitHub

SKILL.md

1	# LobsterLink Tab Share
2
3	Use this when LobsterLink is already loaded in the isolated `openclaw` browser profile and the human wants the agent to use or share an authenticated tab through LobsterLink.
4
5	If LobsterLink is not installed yet, follow the install instructions in this repo's `AGENT-INSTALL.md` first.
6
7	## Recorded Bridge URL
8
9	- `BRIDGE_URL = <RECORDED_BRIDGE_URL>`
10	- During install, replace `<RECORDED_BRIDGE_URL>` in the local/runtime copy of this skill with the full bridge URL, for example `chrome-extension://<extension-id>/bridge.html`.
11	- If this placeholder is still present, the install flow did not finish patching the skill. Discover the extension ID, update the skill, then continue.
12
13	## Installation Status
14
15	- `INSTALLED = true`
16	- Extension ID: <id>
17	- Install date: <YYYY-MM-DD>
18	- If `INSTALLED = true` and bridge URL is resolved, skip the install flow on future runs. Only reinstall if the extension is unloaded or the bridge URL is broken.
19
20	## Hard Rules
21
22	- Use the isolated `openclaw` browser profile, not the human `user` profile, unless explicitly asked otherwise.
23	- When using the OpenClaw `browser` tool for this workflow, target the isolated profile explicitly: `profile="openclaw"` (normally with `target="host"`). Do not use `profile="user"` for LobsterLink hosting or inspection unless the human explicitly asks for the human browser.
24	- Prefer the bridge path, not the popup click path.
25	- Verify bridge state before claiming success.
26	- After hosting starts, the hosted tab MUST be the active tab in its window. This is required, not optional — CDP screencast stalls when the hosted tab is backgrounded and the viewer goes black. `Start Host` auto-focuses the hosted tab; keep it frontmost and re-focus with Show Hosted Tab if it drops.
27	- The bridge page is the source of truth for the peer ID and viewer URL. Read them from the bridge's `Current Peer ID` and `Viewer URL` fields, not from any overlay on the hosted tab. Host state is persisted by the extension, so if `Start Host` leaves the bridge in the background you can reopen `BRIDGE_URL` — the fields will still show the current session.
28
29	## Quick Flow
30
31	1. Confirm the extension is loaded in the isolated browser, not the human browser.
32	2. If using the OpenClaw `browser` tool, use `profile="openclaw"` from the first call onward. Do not inspect LobsterLink tabs with `profile="user"` unless the human explicitly asked for that browser.
33	3. Confirm `BRIDGE_URL` above is a real `chrome-extension://.../bridge.html` URL, not the placeholder.
34	4. Find the requested target tab.
35	5. Open `BRIDGE_URL` from this skill.
36	6. Stop any old host.
37	7. Start hosting the requested tab through the bridge controls. The bridge auto-focuses the hosted tab, which may background the bridge — that is expected.
38	8. Read the peer ID and viewer URL from the bridge's `Current Peer ID` and `Viewer URL` fields. If the bridge is no longer frontmost, reopen `BRIDGE_URL`; host state persists and the fields will still be populated. Do not try to read the ID from an overlay on the hosted tab.
39	9. Verify:
40	- bridge says `Hosting`
41	- peer ID is populated
42	- captured tab matches the request
43	- capture mode is present
44	10. Keep the hosted tab active/frontmost. Confirm the bridge focus indicator reads `Active`, not `Needs Focus`. Do not return the link until this is true.
45	11. Return the peer ID and the public viewer link: `https://lobsterl.ink/?host=<PEER_ID>`
46
47	If the viewer is black, the first recovery step is to refocus the hosted tab so it is frontmost. Only investigate other causes after the focus indicator reads `Active`.
48
49	To stop sharing, click Stop Host on the bridge and verify hosting is false.
50
51	## Verification
52
53	Before replying, confirm all relevant items:
54
55	- extension loaded in isolated profile
56	- target tab exists
57	- bridge page opened
58	- host started or stopped successfully
59	- bridge/runtime state matches the requested outcome
60	- hosted tab is active/frontmost after start (bridge focus indicator reads `Active`)
61
62	## Notes
63
64	- Some browser tools block `chrome-extension://` navigation. If that happens, create the bridge target through CDP instead.
65	- `profile="user"` vs `profile="openclaw"` is a real failure mode in OpenClaw. If the observed tabs/state do not match expectations, first confirm you are attached to the isolated `openclaw` profile before debugging anything else.
66	- A visible popup is not proof that hosting actually started.
67	- Return concrete evidence, not assumptions.

People who liked this also viewed

6 picks

Type

lobsterlink-tab-share

32stars5forks

View on GitHub

How to install lobsterlink-tab-share?

davidguttman/lobsterlink/lobsterlink-tab-share

$npx -y skills add davidguttman/lobsterlink --skill lobsterlink-tab-share

Installs into the current project.

Summary

Files · 1

View on GitHub

SKILL.md

1	# LobsterLink Tab Share
2
3	Use this when LobsterLink is already loaded in the isolated `openclaw` browser profile and the human wants the agent to use or share an authenticated tab through LobsterLink.
4
5	If LobsterLink is not installed yet, follow the install instructions in this repo's `AGENT-INSTALL.md` first.
6
7	## Recorded Bridge URL
8
9	- `BRIDGE_URL = <RECORDED_BRIDGE_URL>`
10	- During install, replace `<RECORDED_BRIDGE_URL>` in the local/runtime copy of this skill with the full bridge URL, for example `chrome-extension://<extension-id>/bridge.html`.
11	- If this placeholder is still present, the install flow did not finish patching the skill. Discover the extension ID, update the skill, then continue.
12
13	## Installation Status
14
15	- `INSTALLED = true`
16	- Extension ID: <id>
17	- Install date: <YYYY-MM-DD>
18	- If `INSTALLED = true` and bridge URL is resolved, skip the install flow on future runs. Only reinstall if the extension is unloaded or the bridge URL is broken.
19
20	## Hard Rules
21
22	- Use the isolated `openclaw` browser profile, not the human `user` profile, unless explicitly asked otherwise.
23	- When using the OpenClaw `browser` tool for this workflow, target the isolated profile explicitly: `profile="openclaw"` (normally with `target="host"`). Do not use `profile="user"` for LobsterLink hosting or inspection unless the human explicitly asks for the human browser.
24	- Prefer the bridge path, not the popup click path.
25	- Verify bridge state before claiming success.
26	- After hosting starts, the hosted tab MUST be the active tab in its window. This is required, not optional — CDP screencast stalls when the hosted tab is backgrounded and the viewer goes black. `Start Host` auto-focuses the hosted tab; keep it frontmost and re-focus with Show Hosted Tab if it drops.
27	- The bridge page is the source of truth for the peer ID and viewer URL. Read them from the bridge's `Current Peer ID` and `Viewer URL` fields, not from any overlay on the hosted tab. Host state is persisted by the extension, so if `Start Host` leaves the bridge in the background you can reopen `BRIDGE_URL` — the fields will still show the current session.
28
29	## Quick Flow
30
31	1. Confirm the extension is loaded in the isolated browser, not the human browser.
32	2. If using the OpenClaw `browser` tool, use `profile="openclaw"` from the first call onward. Do not inspect LobsterLink tabs with `profile="user"` unless the human explicitly asked for that browser.
33	3. Confirm `BRIDGE_URL` above is a real `chrome-extension://.../bridge.html` URL, not the placeholder.
34	4. Find the requested target tab.
35	5. Open `BRIDGE_URL` from this skill.
36	6. Stop any old host.
37	7. Start hosting the requested tab through the bridge controls. The bridge auto-focuses the hosted tab, which may background the bridge — that is expected.
38	8. Read the peer ID and viewer URL from the bridge's `Current Peer ID` and `Viewer URL` fields. If the bridge is no longer frontmost, reopen `BRIDGE_URL`; host state persists and the fields will still be populated. Do not try to read the ID from an overlay on the hosted tab.
39	9. Verify:
40	- bridge says `Hosting`
41	- peer ID is populated
42	- captured tab matches the request
43	- capture mode is present
44	10. Keep the hosted tab active/frontmost. Confirm the bridge focus indicator reads `Active`, not `Needs Focus`. Do not return the link until this is true.
45	11. Return the peer ID and the public viewer link: `https://lobsterl.ink/?host=<PEER_ID>`
46
47	If the viewer is black, the first recovery step is to refocus the hosted tab so it is frontmost. Only investigate other causes after the focus indicator reads `Active`.
48
49	To stop sharing, click Stop Host on the bridge and verify hosting is false.
50
51	## Verification
52
53	Before replying, confirm all relevant items:
54
55	- extension loaded in isolated profile
56	- target tab exists
57	- bridge page opened
58	- host started or stopped successfully
59	- bridge/runtime state matches the requested outcome
60	- hosted tab is active/frontmost after start (bridge focus indicator reads `Active`)
61
62	## Notes
63
64	- Some browser tools block `chrome-extension://` navigation. If that happens, create the bridge target through CDP instead.
65	- `profile="user"` vs `profile="openclaw"` is a real failure mode in OpenClaw. If the observed tabs/state do not match expectations, first confirm you are attached to the isolated `openclaw` profile before debugging anything else.
66	- A visible popup is not proof that hosting actually started.
67	- Return concrete evidence, not assumptions.

People who liked this also viewed

6 picks

Type