ONLY use when user explicitly says 'deep research', 'exhaustive', 'comprehensive report', or 'thorough investigation'. Slower and more expensive than parallel-web-search. For normal research/lookup requests, use parallel-web-search instead.
npxskills add parallel-web/parallel-cursor-plugin--skill parallel-deep-researchLoading…
Research topic: $ARGUMENTS
Requires
parallel-cli≥ 0.3.0. If any command below errors withno such option,no such command, orunrecognized arguments, the user is on an older CLI. Tell them to runparallel-cli update(orpipx upgrade parallel-web-toolsif installed via pipx), then retry.
ONLY use this skill when the user explicitly requests deep/exhaustive research. Deep research is 10-100x slower and more expensive than parallel-web-search. For normal "research X" requests, quick lookups, or fact-checking, use parallel-web-search instead.
Choose a descriptive filename based on the topic (e.g., ai-chip-market-2026, react-vs-vue-comparison). Use lowercase with hyphens, no spaces. Reuse this base name in step 2 as -o "$FILENAME".
parallel-cli research run "$ARGUMENTS" --processor pro-fast --text --no-wait --json
The --text flag tells the API to return a markdown report (with inline citations) when the task completes, instead of the default structured JSON. Use it for narrative/report-style requests, which is what most users want from "deep research." Drop --text if the user explicitly wants structured JSON output.
Optional with --text: pass --text-description "Keep under 1500 words, focus on M&A activity" to steer length, format, or focus.
If this is a follow-up to a previous research or enrichment task where you know the interaction_id, add context chaining:
parallel-cli research run "$ARGUMENTS" --processor lite-fast --text --no-wait --json --previous-interaction-id "$INTERACTION_ID"
By chaining interaction_id values across requests, each follow-up question automatically has the full context of prior turns — so you can drill deeper without restating what was already researched. Use a lighter processor (lite-fast or base-fast) for follow-ups since the heavy lifting was done in the initial turn.
This returns instantly. Do NOT omit --no-wait — without it the command blocks for minutes and will time out.
Processor options (choose based on user request):
| Processor | Expected latency | Use when |
|---|---|---|
lite-fast | 10–60s | Quick lookups, follow-ups |
base-fast | 15–100s | Simple questions |
core-fast | 1–5 min | Moderate research |
pro-fast | 2–10 min | Default — exploratory research, good depth/speed balance |
ultra-fast | 5–25 min | Multi-source deep research (~2× cost) |
| / / |
Notes on the -fast suffix: -fast tiers use cached web data and are quicker. The non-fast variants (pro, ultra, etc.) re-fetch fresher data — slower but better for very recent events. Default to -fast unless the user specifically asks about news from the last day or two.
Run parallel-cli research processors to see the full list with latencies.
Parse the JSON output to extract the run_id, interaction_id, and monitoring URL. Immediately tell the user:
Tell them they can background the polling step to continue working while it runs.
parallel-cli research poll "$RUN_ID" -o "$FILENAME" --timeout 540
Important:
--timeout 540 (9 minutes) to stay within tool execution limits--json — the full output is large and will flood context. The -o flag writes results to files instead.-o "$FILENAME":
$FILENAME.json is always written (metadata + basis)$FILENAME.md is written only if step 1 used --text (markdown report)--force if re-polling and you want to overwrite existing filesHigher processor tiers can take longer than 9 minutes. If the poll exits without completing:
parallel-cli research poll command to continue waitingAfter step 1: Share the monitoring URL (for tracking progress only — it is not the final report).
After step 2:
$FILENAME.md — formatted markdown report (if --text was used)$FILENAME.json — metadata and basisinteraction_id and tell the user they can ask follow-up questions that build on this research (e.g., "drill deeper into X" or "compare that to Y")Do NOT re-share the monitoring URL after completion — the results are in the files, not at that link.
Ask the user if they would like to read through the files for more detail. Do NOT read the file contents into context unless the user asks.
Remember the interaction_id — if the user asks a follow-up question that relates to this research, use it as --previous-interaction-id in the next research or enrichment command.
parallel-cli binary is not installedIf the shell reports command not found: parallel-cli (i.e. the binary itself is missing — distinct from a No such command error from a stale CLI, which the in-body guidance above covers), stop immediately. Do NOT search the web yourself, do NOT use any built-in search tools, and do NOT try to answer the query from your own knowledge. Instead, tell the user:
parallel-cli is not installed/parallel-setup to install itultra2x-fastultra4x-fastultra8x-fast| up to 2 hr |
| Hardest questions, only when explicitly requested |
Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.
Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.
Set up and use 1Password CLI (op). Use when installing the CLI, enabling desktop app integration, signing in (single or multi-account), or reading/injecting/running secrets via op.
CLI to manage emails via IMAP/SMTP. Use `himalaya` to list, read, write, reply, forward, search, and organize emails from the terminal. Supports multiple accounts and message composition with MML (MIME Meta Language).
Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.
Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.
Set up and use 1Password CLI (op). Use when installing the CLI, enabling desktop app integration, signing in (single or multi-account), or reading/injecting/running secrets via op.
CLI to manage emails via IMAP/SMTP. Use `himalaya` to list, read, write, reply, forward, search, and organize emails from the terminal. Supports multiple accounts and message composition with MML (MIME Meta Language).