aboutsummaryrefslogtreecommitdiff
path: root/skills
diff options
context:
space:
mode:
authoramankumarsingh77 <amankumarsingh7702@gmail.com>2026-07-28 21:17:13 +0530
committerAman Kumar <145339995+amankumarsingh77@users.noreply.github.com>2026-08-02 19:12:46 +0530
commitea11182a0e8cb62d208b5b53a60c98c8bdef9e9a (patch)
tree665fb355b902e5f067694d1e953039f6713e8245 /skills
parent91f5ad12fc04264e0423b37c4871c826bb98a66b (diff)
feat!: remove the deep-research feature
The harness ships browser tools; orchestrating a multi-agent research workflow on top of them is the agent's job, not this extension's. Drops the skill, the /deep-research command, and the web-search-researcher subagent config. browser_web_search and browser_read_page are untouched — the two tests that covered their pure parsers move to test/domains/, where the test glob still picks them up. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Diffstat (limited to 'skills')
-rw-r--r--skills/deep-research/SKILL.md66
-rw-r--r--skills/pi-browser-harness/SKILL.md2
2 files changed, 1 insertions, 67 deletions
diff --git a/skills/deep-research/SKILL.md b/skills/deep-research/SKILL.md
deleted file mode 100644
index 846c522..0000000
--- a/skills/deep-research/SKILL.md
+++ /dev/null
@@ -1,66 +0,0 @@
----
-name: deep-research
-description: Use when the user asks you to research a topic on the web, do deep research, investigate something across multiple sources, or produce a cited report / literature review from the live web. Decomposes the question, fans out isolated web-search-researcher subagents (one per sub-question) that scrape the real browser, then synthesizes a source-cited Markdown report. Trigger phrases include "research", "deep research", "look this up and cite sources", "investigate", "compare X and Y with sources".
----
-
-# Deep Research
-
-Turn a research question into a **cited Markdown report** by fanning out to isolated `web-search-researcher` subagents that use the real browser, then synthesizing their distilled findings. Every claim in the final report carries a source link.
-
-This runs on two browser tools — `browser_web_search` (ranked SERP, links only) and `browser_read_page` (URL → clean article text) — used *inside the subagents*, not by you directly. Both tools open their own isolated tabs, so **the fan-out never disturbs the user's tabs or current page.** You do not need `/browser-setup` to have been run by you; if the browser isn't connected the subagents' first tool call will report `not_connected` — relay that and ask the user to run `/browser-setup`.
-
-## Workflow
-
-### 1. Decompose
-
-Break the question into **3–6 focused sub-questions**, each independently answerable from the web. Cover the distinct facets — definitions, current state, competing options, trade-offs, recent changes — not slight rewordings of the same thing. Aim for coverage: if you synthesized perfect answers to all sub-questions, the original question should be fully answered.
-
-State the sub-questions to the user before dispatching (a short numbered list) so the plan is visible.
-
-### 2. Fan out
-
-Dispatch **one `web-search-researcher` subagent per sub-question**, in parallel where the runtime allows. Each subagent runs in isolated context and returns a distilled, source-linked finding (claims + urls) — not raw pages. Give each subagent exactly one sub-question plus any constraints (recency, specific ecosystem, authoritative sources to prefer).
-
-Do not do the searching yourself — that is the subagents' job, and their isolation is what keeps your context clean enough to synthesize well.
-
-### 3. Assess coverage — loop with a hard ceiling
-
-After each round of findings, self-assess: **is every sub-question answered, or did findings surface new gaps worth a follow-up search?**
-
-- If gaps remain and you are under the ceiling, dispatch a second round of researchers targeting only the gaps (rephrased or newly discovered sub-questions).
-- **Hard ceiling:** at most **2 rounds** and **8 researcher subagents total**. When you hit either limit, stop searching, synthesize with what you have, and list the unresolved gaps explicitly in the report. Never loop indefinitely chasing completeness.
-
-Handle subagent-reported tool failures:
-- A subagent reporting a `browser_web_search` `invalid_state` with `reason: "captcha"` means a bot wall. **Surface this to the user immediately** and do not spawn a tight retry loop — ask whether to continue, wait, or narrow scope.
-- `reason: "no_results"` is already handled inside the subagent (one rephrase); if it still comes back empty, treat that sub-question as a gap.
-
-### 4. Synthesize a cited report
-
-Merge the distilled findings into a **Markdown report written to a file** (e.g. `research-<topic-slug>.md` in the working directory — tell the user the path). Structure:
-
-```
-# {The research question}
-
-## Summary
-{A few paragraphs answering the question, synthesized across sources.}
-
-## {Sub-topic / sub-question 1}
-{Findings, in prose. Every claim carries a source link inline: … as shown in [Title](url).}
-
-## {Sub-topic 2}
-...
-
-## Open questions / gaps
-{Anything the ceiling left unresolved, or where sources conflicted.}
-
-## Sources
-{Deduplicated list of every URL cited, with titles.}
-```
-
-Rules for the report:
-- **Every factual claim carries a source link** — inline `[title](url)`. No unsourced assertions.
-- **Attribute conflicts.** Where sources disagree, present both and cite each.
-- **Distinguish synthesis from quotation.** Don't fabricate precision the sources didn't provide.
-- **Be honest about gaps.** The gaps section is mandatory when the ceiling cut off coverage — an incomplete-but-honest report beats a complete-looking-but-padded one.
-
-After writing the file, give the user a short chat summary and the file path — don't paste the whole report into the conversation.
diff --git a/skills/pi-browser-harness/SKILL.md b/skills/pi-browser-harness/SKILL.md
index fa76a2e..36d0346 100644
--- a/skills/pi-browser-harness/SKILL.md
+++ b/skills/pi-browser-harness/SKILL.md
@@ -36,7 +36,7 @@ What do you need to know?
Pass `@(x,y)` from `browser_snapshot` straight to `browser_click`. No screenshot round-trip.
-`browser_web_search` and `browser_read_page` each run in their own isolated tab and never touch the user's current tab. For a multi-source question that needs a synthesized, cited report, use the **deep-research** skill (or `/deep-research <question>`): it fans out isolated `web-search-researcher` subagents over both tools and writes a source-cited Markdown report.
+`browser_web_search` and `browser_read_page` each run in their own isolated tab and never touch the user's current tab. Pair them for a research question: search for candidate URLs, then read the promising ones.
## Connection Setup