# Perplexity Research

> Investigación web aumentada con el brain: envía contexto a Perplexity, que busca con citas y devuelve qué es NUEVO frente a lo que el brain ya conoce.

Fuente: https://skillsagentes.com/skills/garrytan/gbrain/perplexity-research
Markdown: https://skillsagentes.com/skills/garrytan/gbrain/perplexity-research.md

Repositorio: https://github.com/garrytan/gbrain
Autor: garrytan
Licencia: MIT
Actualizado: hace 21 días
Coste de contexto: 87 tok instalada, 1.7k tok al activarse, 1.9k tok con todos los archivos del bundle
Bundle: 2 archivos, 7 KB
Permisos que pide: ninguno declarado

## Instalación

Un skill son archivos markdown: los mismos archivos valen para cualquier agente y lo único que cambia es el directorio de destino, es decir la bandera `--agent`. Añade `-g` para instalarlo en todos los proyectos de la máquina.

```bash
# Claude Code
npx -y skills add garrytan/gbrain --skill perplexity-research --agent claude-code
# Cursor
npx -y skills add garrytan/gbrain --skill perplexity-research --agent cursor
# Codex
npx -y skills add garrytan/gbrain --skill perplexity-research --agent codex
# Gemini CLI
npx -y skills add garrytan/gbrain --skill perplexity-research --agent gemini
# Windsurf
npx -y skills add garrytan/gbrain --skill perplexity-research --agent windsurf
# Cline
npx -y skills add garrytan/gbrain --skill perplexity-research --agent cline
```

## Qué hace

- Envía contexto del brain sobre un tema a Perplexity para que busque en la web con citas
- Devuelve lo que es NUEVO frente a lo que el brain ya sabe, no hechos ya asentados
- Escribe una página de investigación estructurada en research/<slug>.md con citas
- Enlaza entidades mencionadas (personas, empresas) siguiendo la Iron Law

## Cuándo usarla

- Enriquecimiento de entidades (personas, empresas) que necesitan contexto web actual
- Chequeos de estado actual o monitoreo de deals/companies
- Necesitas detectar qué cambió respecto a lo que ya sabe el brain
- Briefings matutinos donde no quieres re-narrar hechos ya conocidos

## Cuándo no

- Para simples fetch de URL (usa web_fetch)
- Para consultas solo contra el brain (usa gbrain query)
- Para lookups de datos estructurados contra un tracker (usa data-research)

## Qué la activa

- "¿Qué hay de nuevo sobre esta empresa desde la última vez que la investigamos?"
- "Haz research de Perplexity sobre el estado actual de este deal"
- "Surface new developments sobre esta persona"
- "¿Qué cambió en esta compañía esta semana?"

## Antes de instalar

- Requiere PERPLEXITY_API_KEY configurada en el entorno del agente o en ~/.gbrain/.env.
- Variables de entorno: PERPLEXITY_API_KEY
- makes network requests
- needs API credentials

## Archivos

- SKILL.md — 7 KB
- routing-eval.jsonl — 760 B

## SKILL.md

Reproducido tal cual desde garrytan/gbrain bajo MIT. Esta sección es el documento original y está en inglés.

# perplexity-research — Brain-Augmented Web Research

> **Convention:** see [conventions/quality.md](../conventions/quality.md) for
> citation rules; every claim from web research lands with a verifiable
> citation, not a paraphrase.
>
> **Convention:** see [conventions/brain-first.md](../conventions/brain-first.md)
> for the lookup chain. This skill ENFORCES brain-first by sending brain
> context as part of the Perplexity prompt — the web search focuses on
> the delta between brain knowledge and current web state.

## What this does

Combines existing brain knowledge with Perplexity's web search. The
agent sends brain context about a topic into a Perplexity query;
Perplexity searches + reads + synthesizes multiple pages with citations,
focused on what's NEW relative to the supplied context.

**The key insight:** Perplexity doesn't just search — it reads and
synthesizes with citations. By sending brain context in the
instructions, it knows what you already know, so it surfaces the delta
instead of repeating settled fact.

## When to use this vs other tools

| Need | Use |
|------|-----|
| Deep research with citations | **This skill** — Perplexity + Opus |
| Quick URL content | `web_fetch` |
| Brain-only lookup | `gbrain query` / `gbrain search` |
| Real-time social monitoring | external X / social-media collectors |
| Structured data lookup against a tracker | `skills/data-research/SKILL.md` |

## Output structure

The research output lands as a brain page under `research/<slug>.md` with
this structure:

```markdown
---
title: "[Topic] — Research [YYYY-MM-DD]"
type: research
date: YYYY-MM-DD
brain_context_slugs: ["pages whose context was sent to Perplexity"]
recency_filter: "[hour|day|week|month|none]"
---

# [Topic] — Research [YYYY-MM-DD]

> Executive summary: 2-3 sentences on the delta between brain knowledge
> and current web state.

## Key New Developments
What's changed since the brain was last updated on this topic.

## Confirming Signals
Web evidence validating existing brain knowledge.

## Contradictions or Updates
Things that conflict with the brain — these need a closer look.

## Recommended Brain Updates
Specific page updates the user might want to make based on this research.
Each item: which page, what to add or change, source URL.

## Citations
- [Source title](URL) — accessed YYYY-MM-DD
- [Source title](URL) — accessed YYYY-MM-DD
- ...
```

## Invocation

The skill is markdown agent instructions; the agent uses Perplexity's
API directly (or a host-provided `perplexity` CLI if installed):

```bash
# 1. Pull brain context
gbrain get <slug>                    # or
gbrain query "<topic keywords>"

# 2. Compose the Perplexity query with brain context inline:
#    """
#    Topic: <topic>
#    Brain context (what we already know): <embedded gbrain content>
#    Find: what's NEW since 2026-MM-DD that the brain doesn't reflect.
#    Cite every claim.
#    """

# 3. Call Perplexity API or the host's perplexity binary:
#    curl https://api.perplexity.ai/chat/completions \
#      -H "Authorization: Bearer $PERPLEXITY_API_KEY" \
#      -H "Content-Type: application/json" \
#      -d '{"model": "sonar-pro", "messages": [{"role":"user","content":"..."}]}'

# 4. Write the structured research page via put_page:
gbrain put research/<slug>      # via the put_page operation

# 5. Cross-link entities mentioned (people, companies) per Iron Law.
```

## Models

| Model | Cost / query | Use when |
|-------|-------------|----------|
| Perplexity sonar-pro | ~\$0.04 | Deep analysis, entity enrichment, deal research |
| Perplexity sonar | ~\$0.007 | Quick lookups, bulk monitoring, briefing pipelines |

Default to sonar-pro. Drop to sonar for bulk / cron contexts where cost
matters more than depth.

## Integration patterns

### Entity enrichment

Called by `skills/enrich/SKILL.md` when an entity page (person, company)
needs current web context:

```bash
BRAIN=$(gbrain get people/<slug> 2>/dev/null)
# Send <slug>'s page content as brain_context to Perplexity, get current
# news / role / context, then update the brain page with what's new.
```

### Deal / company monitoring (cron)

For each active item under `deals/` or `companies/`:

```bash
# Weekly: pull recent news per company; flag changes for review.
```

### Morning briefing

Replace raw `web_fetch` calls in briefing pipelines with this skill so
the agent doesn't re-narrate already-known facts.

## Recency filter

Pass `recency_filter` to Perplexity: `hour | day | week | month`. Useful
for news-cycle topics; omit for evergreen research.

## Anti-Patterns

- ❌ Sending NO brain context. Then it's just a search — use `web_fetch`
  instead.
- ❌ Truncating the brain context. The whole point is "knows what you
  know." Send dense context.
- ❌ Discarding citations. Every claim in the output must have a URL.
- ❌ Skipping the cross-link step when entities are mentioned. Iron Law.

## Environment

- `PERPLEXITY_API_KEY` set in the agent's environment (or in
  `~/.gbrain/.env`).
- Optional: install Perplexity's official CLI for richer streaming output.

## Related skills

- `skills/academic-verify/SKILL.md` — wraps perplexity-research for
  citation-verified academic claim checking
- `skills/enrich/SKILL.md` — calls perplexity-research as part of the
  entity-enrichment loop
- `skills/data-research/SKILL.md` — structured-data trackers (different
  shape: parameterized YAML recipes, not free-form research)

## Contract

This skill guarantees:

- Routing matches the canonical triggers in the frontmatter.
- Output written under the directories listed in `writes_to:` (when applicable).
- Conventions referenced (`quality.md`, `brain-first.md`, `_brain-filing-rules.md`) are followed.
- Privacy contract preserved: no real names, no fork-specific filesystem path literals, no upstream-fork references.

The full behavior contract is documented in the body sections above; this section exists for the conformance test.

## Output Format

The skill's output shape is documented inline in the body sections above (see "Output", "Brain page format", or equivalent). The literal section header here exists for the conformance test (`test/skills-conformance.test.ts`).

## Dónde encaja

- Categoría: [Investigación](https://skillsagentes.com/categorias/investigacion.md) — Investigación estructurada, búsqueda de fuentes y síntesis.
- Creador: [garrytan](https://skillsagentes.com/creators/garrytan.md) — 134 skills en el directorio
- [Todas las skills](https://skillsagentes.com/skills.md)
- [Ranking de instalaciones](https://skillsagentes.com/ranking.md)

## Otras skills del mismo repositorio

- [Setup](https://skillsagentes.com/skills/garrytan/gbrain/setup.md): Configura GBrain con auto-aprovisionamiento de Supabase o PGLite, inyección en AGENTS.md y primera importación.
- [Maintain](https://skillsagentes.com/skills/garrytan/gbrain/maintain.md): Chequeos de salud del brain: aplicación de back-links, auditoría de citas, validación de filing, detección de info obsoleta, páginas huérfanas y benchmarks.
- [Schema Unify](https://skillsagentes.com/skills/garrytan/gbrain/schema-unify.md): Migra un brain de gbrain-base a la taxonomía de 14 tipos canónicos de gbrain-base-v2 usando gbrain onboard --check y el handler Minion unify-types.
- [Retrieval Reflex](https://skillsagentes.com/skills/garrytan/gbrain/retrieval-reflex.md): Cuándo y qué recuperar: abre la página del brain de una entidad relevante antes de responder desde memoria.
- [Minion Orchestrator](https://skillsagentes.com/skills/garrytan/gbrain/minion-orchestrator.md): Skill unificado de Minions para jobs deterministas de shell y orquestación de subagentes LLM: cola durable, observable y controlable, más la doctrina de ejecución durable para operaciones largas.

---

Skills Agentes · [Índice de páginas en markdown](https://skillsagentes.com/sitemap.md) · [Inicio](https://skillsagentes.com/index.md)