nav-deep-research

Produces cited web research reports through a gated multi-step pipeline with knowledge graph ingestion.

232|12|Updated Oct 10, 2025
One-click install
npx skills add https://github.com/qf-studio/navigator --skill nav-deep-research-qf-studio
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: nav-deep-research
Source: https://github.com/qf-studio/navigator/tree/main/skills/nav-deep-research
Command: npx skills add https://github.com/qf-studio/navigator --skill nav-deep-research-qf-studio

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Answering questions that require evidence from outside the codebase usually means ad-hoc web searches, uncited summaries, and no record of what was found. This Skill runs a structured deep research pipeline that decomposes a query, fetches and stores sources, drafts a cited report, adversarially critiques it, patches findings, and ships only after a deterministic gate passes. ## Core Features & Use Cases - Six-step gated pipeline: Decompose the query into atomic items, sweep the web with parallel fetcher subagents, draft one report, critique it, patch findings, and ship only when the ship gate passes. - Citation contract and report format: Enforces [n] citations, a Sources table with search lenses (breadth, canonical, adversarial), typed Key findings, an answer-first Summary, and a paragraph cap, all checked by ship_gate.py. - Knowledge graph ingestion: Converts typed Key findings into graph memories with URL evidence tagged by fetch date and content hash, so conclusions persist across sessions. - Use Case: Ask "deep research on the current state of free-threaded CPython" and receive a cited report.md with an answer-first summary, per-question sections, open questions, and conclusions stored in the project knowledge graph. ## Quick Start Enable deep research in the Navigator config, then ask the assistant to do deep research on your question and wait for the cited report to be written under .agent/research.

Frequently Asked Questions about nav-deep-research

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

FAQPage Schema
How do I run a deep research report on a topic?

Enable deep_research in .agent/.nav-config.json, then ask for deep research on your question. The skill initializes a run, plans searches across breadth, canonical, and adversarial lenses, fetches sources, and produces a cited report.md under .agent/research/<slug>/.

How does the skill verify the quality of a research report?

A deterministic ship gate checks required sections, citation resolution against the Sources table, minimum source counts, typed key findings, summary structure, and paragraph length. Gate failures are fixed by editing the report, never by weakening the checks.

Can I resume an interrupted deep research run?

Yes. Say "resume research <slug>" and the run manifest determines the next step, falling back to an artifact scan of search-plan.md, sources, report.md, critic findings, patch log, and ship.json when the manifest is stale.

When should I use this instead of a codebase research agent?

Use it for questions about topics outside the codebase, such as literature surveys or technology comparisons. For questions about the project's own code, use the navigator-research agent instead, as this skill only fetches external web sources.

What are the limitations of this web research approach?

It has no SQLite vault, no academic APIs, no PDF extraction, no browser lane, and no source quality scoring. Fetched source bodies are gitignored, though they can be rebuilt from recorded URLs with the refetch command.