perplexity-research

Combines brain context with Perplexity web search to surface new developments with citations.

Updated Aug 17, 2026
One-click install
npx skills add https://github.com/AMC-JTC/gbrain-1 --skill perplexity-research-amc-jtc
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: perplexity-research
Source: https://github.com/AMC-JTC/gbrain-1/tree/main/plugin/skills/perplexity-research
Command: npx skills add https://github.com/AMC-JTC/gbrain-1 --skill perplexity-research-amc-jtc

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Web research often repeats what you already know, wasting time re-reading settled facts. This Skill sends your existing brain context to Perplexity so the web search focuses only on the delta — what is new, changed, or contradictory relative to your knowledge base. ## Core Features & Use Cases - Brain-Augmented Search: Sends existing brain page content as context in the Perplexity prompt so results highlight only new information. - Cited, Structured Output: Writes a research page under research/<slug>.md with sections for new developments, confirming signals, contradictions, recommended brain updates, and citations. - Model & Recency Control: Choose between sonar-pro for deep analysis or sonar for bulk monitoring, and apply recency filters (hour, day, week, month). - Use Case: Run a weekly cron over active deals to pull recent company news, flag changes, and write cited research pages for review. ## Quick Start Ask the agent to run perplexity-research on a company or person to surface new developments the brain does not already cover.

Frequently Asked Questions about perplexity-research

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

FAQPage Schema
How do I run brain-augmented web research with Perplexity?

Pull brain context with gbrain get or gbrain query, embed it in the Perplexity prompt asking what is new, then call the Perplexity chat completions API with sonar-pro. Write the structured result as a research page via gbrain put.

When should I use perplexity-research vs web_fetch?

Use perplexity-research for deep multi-source research with citations and delta detection against brain knowledge. Use web_fetch only for quick retrieval of a single URL's content, and gbrain query for brain-only lookups.

What Perplexity model should I use for research queries?

Default to sonar-pro at roughly $0.04 per query for deep analysis, entity enrichment, and deal research. Drop to sonar at about $0.007 per query for bulk monitoring, cron jobs, and briefing pipelines where cost matters more than depth.

Does perplexity-research require an API key?

Yes, it requires PERPLEXITY_API_KEY set in the agent's environment or in ~/.gbrain/.env. Optionally you can install Perplexity's official CLI for richer streaming output.

What are common mistakes when using brain-augmented search?

Sending no brain context reduces it to a plain search, and truncating context defeats the delta detection. Also avoid discarding citations, since every claim in the output must have a source URL.