deep-research

Conduct multi-source investigations and produce cited research briefs with provenance tracking.

Updated Sep 11, 2026
One-click install
npx skills add https://github.com/cameronbracken/waterology-research --skill deep-research-cameronbracken
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: deep-research
Source: https://github.com/cameronbracken/waterology-research/tree/main/skills/deep-research
Command: npx skills add https://github.com/cameronbracken/waterology-research --skill deep-research-cameronbracken

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Answering complex questions thoroughly requires gathering evidence from many sources, verifying claims, and tracking where every fact came from. This Skill automates that entire investigation workflow, delivering a cited research brief with a provenance record instead of an unsourced chat answer. ## Core Features & Use Cases - Structured Investigation Workflow: Follows a plan-approve-research-draft-cite-review protocol with durable artifacts (plans, drafts, cited versions) saved under docs/ or papers/. - Source Provenance and Verification: Maps every critical claim to a source URL, runs verifier and reviewer agents, and writes a .provenance.md sidecar recording consulted, accepted, and rejected sources. - Reference Library Integration: Builds a Zotero library while researching via literature_search, zotero_capture, and OpenAlex, with sync of pending metadata and PDFs before delivery. - Use Case: Ask for a comprehensive analysis of a technical topic; the Skill proposes a research plan, delegates to researcher agents for broad surveys, verifies citations, and delivers a cited brief with full provenance. ## Quick Start Ask the assistant to run deep research on your topic, for example: do a deep research investigation on the current state of battery recycling methods and produce a cited report.

Frequently Asked Questions about deep-research

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run a deep research investigation with cited sources?▼

Invoke the deep-research skill with your topic. It creates a research plan for your approval, gathers evidence from primary papers and official documentation, verifies each claim against a source, and delivers a cited brief in docs/ or papers/ with a provenance sidecar.

How does deep research verify claims and citations?▼

Every critical claim, number, and figure is mapped to a source URL or research note before citation. A verifier agent checks the cited draft for FATAL, MAJOR, and MINOR findings, then a reviewer agent runs a separate pass after citation completes.

Does deep research integrate with Zotero and OpenAlex?▼

Yes. It uses OPENALEX_API_KEY and ZOTERO_API_KEY from the environment when present, records searches via literature_search, captures sources with zotero_capture, and syncs pending metadata and PDFs with waterology zotero sync before delivery.

What happens if a research source or provider is unavailable?▼

The workflow continues in degraded mode after plan approval. Failures are recorded, blocked checks are marked as Verification: BLOCKED, and a partial final artifact plus provenance is still written rather than losing the research results.

When should I use direct search instead of delegated research agents?▼

Use direct search for narrow questions or single facts needing roughly ten or fewer search and fetch operations. Delegate to two to four researcher agents for comparisons or broad surveys with distinct facets that can be owned separately.