Web (search + browse + cite + CDP)
Overview
Default to web search when info may have changed, is niche, or the user asks. Use web.run for queries; follow citation rules and prefer authoritative sources. If interaction with a live page is needed, start Chrome with the bundled CDP helpers (tools/start.js, nav.js, eval.js, pick.js, screenshot.js, click-link.js).
When to Use
- User says search/browse/look up/verify.
- Topics likely to change: news, prices, releases, schedules, policies, versions, CEOs, rankings, travel, recommendations.
- Niche/uncertain terms or potential typos.
- Need direct quotes/links/citations.
- Need to click, navigate, or extract structured data from a live site (use CDP tools).
Core Pattern
- Clarify intent + recency if not given.
- Issue 1–3 targeted
search_query calls (diverse terms/domains as needed).
- Open promising results; skim with
find for key patterns (names, dates, numbers).
- Extract 3–5 load-bearing facts; ensure dates are explicit.
- Cite each non-obvious fact with citeturnX… immediately after the sentence.
- State assumptions; if data missing, say so briefly.
- If interaction is required, start Chrome and use CDP helpers (below) to click/navigate/screenshot.
Query Tips
- Add qualifiers:
site:docs.example.com, version numbers, region.
- For names with ambiguity, include org or role.
- For recency: set
recency days on search_query when asking “today/latest”.
- Run multiple queries in one
search_query array to save turns.
Reading & Validation
- Check publish date vs event date; prefer the latest credible source.
- Cross-check at least two domains for important claims.
- Avoid low-trust domains unless only source; if used, flag confidence.
CDP Browser Controls (Chrome DevTools Protocol)
- Start Chrome with remote debugging on :9222
./tools/start.js # fresh profile
./tools/start.js --profile # reuse your profile/cookies
- Navigate current tab or open new tab
./tools/nav.js https://example.com
./tools/nav.js https://example.com --new
- Evaluate JS in active tab
./tools/eval.js 'document.title'
./tools/eval.js 'document.querySelectorAll(\"a\").length'
- Screenshot current viewport
./tools/screenshot.js
- Pick elements interactively
./tools/pick.js "Click the submit button"
- Click a known link/text
./tools/click-link.js "Submit"
- All CDP scripts live in
skills/web/tools/; ensure they’re executable.
Citations
- Place after punctuation; avoid bold/italics/code fences.
- Group multiple sources: citeturn2search1turn2open0
- Cite every fact that isn’t obvious or could have changed since 2024.
- Don’t paste raw URLs; citations render as links.
Output Style
- Be concise; surface the answer first, then short context.
- Include exact dates (e.g., “as of 2025-12-12”).
- If unresolved, say what you tried and what’s missing.
Red Flags
- Answering from memory when the topic is time-sensitive.
- No dates on “latest/new/current”.
- Failing to cite or citing irrelevant pages.
- Over-long quotes; keep ≤25 words per source.
- Ignoring conflicting sources—mention disagreement briefly.
- Using CDP without starting Chrome on :9222 via
tools/start.js.
- Forgetting to give citations when summarizing CDP-derived content.
1---2name: web3description: Use to browse or verify external info—run web searches, open pages, drive Chrome via CDP tools, and cite sources when facts may be outdated, niche, or user-requested.4---5
6# Web (search + browse + cite + CDP)
7
8## Overview
9Default to web search when info may have changed, is niche, or the user asks. Use `web.run` for queries; follow citation rules and prefer authoritative sources. If interaction with a live page is needed, start Chrome with the bundled CDP helpers (`tools/start.js`, `nav.js`, `eval.js`, `pick.js`, `screenshot.js`, `click-link.js`).
10
11## When to Use
12- User says search/browse/look up/verify.
13- Topics likely to change: news, prices, releases, schedules, policies, versions, CEOs, rankings, travel, recommendations.
14- Niche/uncertain terms or potential typos.
15- Need direct quotes/links/citations.
16- Need to click, navigate, or extract structured data from a live site (use CDP tools).
17
18## Core Pattern
191) Clarify intent + recency if not given.
202) Issue 1–3 targeted `search_query` calls (diverse terms/domains as needed).
213) Open promising results; skim with `find` for key patterns (names, dates, numbers).
224) Extract 3–5 load-bearing facts; ensure dates are explicit.
235) Cite each non-obvious fact with citeturnX… immediately after the sentence.
246) State assumptions; if data missing, say so briefly.
257) If interaction is required, start Chrome and use CDP helpers (below) to click/navigate/screenshot.
26
27## Query Tips
28- Add qualifiers: `site:docs.example.com`, version numbers, region.
29- For names with ambiguity, include org or role.
30- For recency: set `recency` days on `search_query` when asking “today/latest”.
31- Run multiple queries in one `search_query` array to save turns.
32
33## Reading & Validation
34- Check publish date vs event date; prefer the latest credible source.
35- Cross-check at least two domains for important claims.
36- Avoid low-trust domains unless only source; if used, flag confidence.
37
38## CDP Browser Controls (Chrome DevTools Protocol)
39- Start Chrome with remote debugging on :9222
40 ```bash
41 ./tools/start.js # fresh profile
42 ./tools/start.js --profile # reuse your profile/cookies
43 ```
44- Navigate current tab or open new tab
45 ```bash
46 ./tools/nav.js https://example.com
47 ./tools/nav.js https://example.com --new
48 ```
49- Evaluate JS in active tab
50 ```bash
51 ./tools/eval.js 'document.title'
52 ./tools/eval.js 'document.querySelectorAll(\"a\").length'
53 ```
54- Screenshot current viewport
55 ```bash
56 ./tools/screenshot.js
57 ```
58- Pick elements interactively
59 ```bash
60 ./tools/pick.js "Click the submit button"
61 ```
62- Click a known link/text
63 ```bash
64 ./tools/click-link.js "Submit"
65 ```
66- All CDP scripts live in `skills/web/tools/`; ensure they’re executable.
67
68## Citations
69- Place after punctuation; avoid bold/italics/code fences.
70- Group multiple sources: citeturn2search1turn2open0
71- Cite every fact that isn’t obvious or could have changed since 2024.
72- Don’t paste raw URLs; citations render as links.
73
74## Output Style
75- Be concise; surface the answer first, then short context.
76- Include exact dates (e.g., “as of 2025-12-12”).
77- If unresolved, say what you tried and what’s missing.
78
79## Red Flags
80- Answering from memory when the topic is time-sensitive.
81- No dates on “latest/new/current”.
82- Failing to cite or citing irrelevant pages.
83- Over-long quotes; keep ≤25 words per source.
84- Ignoring conflicting sources—mention disagreement briefly.
85- Using CDP without starting Chrome on :9222 via `tools/start.js`.
86- Forgetting to give citations when summarizing CDP-derived content.