# perplexity

This skill wires Perplexity into Claude: web search, conversational answers, and deep research through an agent. Handy when you need current information rather than library docs.

- skill · `type=skill` · Claude Code · 140 installs
- Author: davila7
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/skills/ai-research/perplexity
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/skills/perplexity

## What it does

The skill tells the agent which tool to reach for. Plain lookups go to `mcp__perplexity__perplexity_search`, explanations grounded in the web go to `mcp__perplexity__perplexity_ask`, and deep dives go to the `/research <topic>` agent. The `mcp__perplexity__perplexity_research` tool is off-limits here — the skill points you at the researcher agent instead.

Searches are meant to run tight: `max_results: 3` and `max_tokens_per_page: 512`, since the defaults bloat context. Raise those only when the first pass came back empty or the topic genuinely needs several sources.

Scope is the real constraint. Library and framework docs belong to Context7 MCP, anything mentioning `gt` belongs to Graphite MCP, and questions about the current workspace belong to Nx MCP. Mix those up and your query hits the open web instead of exact docs — you will notice it in the answers. Running this requires the Perplexity MCP server with an API key configured.

## Requirements
- Works with: Context7

## Install

### Claude Code (native platform)

1. **claude-code-templates**
```bash
npx claude-code-templates@latest --skill ai-research/perplexity
```

2. **Skills CLI (Vercel)**
```bash
npx skills add davila7/claude-code-templates --skill perplexity -a claude-code
```

3. **Manually: put the files in place**
- File: `~/.claude/skills/perplexity/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/perplexity/

### Codex

**Manually: put the files in place**
- File: `.agents/skills/perplexity/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

**Manually: put the files in place**
- File: `.cursor/skills/perplexity/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install davila7/claude-code-templates perplexity
```

2. **Manually: put the files in place**
- File: `.github/skills/perplexity/SKILL.md`

### Gemini CLI

**Platform CLI**
```bash
gemini skills install https://github.com/davila7/claude-code-templates --path cli-tool/components/skills/ai-research/perplexity
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/perplexity/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/skills/ai-research/perplexity

## When to use it
- find current best practices that local docs do not cover
- get a conversational explanation backed by web sources
- run a multi-source deep dive on a topic
- route a query to the web instead of framework documentation
- keep context small during web searches

## Example prompts
- find recent articles on postgres migrations
- explain how postgres advisory locks work
- run /research on microservices trade-offs

## Similar
- [perplexity-search](https://affpapa.org/en/nevibecode/skills/dotneet-perplexity-search.md) — skill · 455 installs
- [research-external](https://affpapa.org/en/nevibecode/skills/research-external.md) — skill · 501 installs
- [deep-research](https://affpapa.org/en/nevibecode/skills/glebis-deep-research.md) — skill · 324 installs
- [microsoft-docs](https://affpapa.org/en/nevibecode/skills/github-microsoft-docs.md) — skill · 14881 installs
- [mcp-server-patterns](https://affpapa.org/en/nevibecode/skills/mcp-server-patterns.md) — skill · 4700 installs
- [exa-search](https://affpapa.org/en/nevibecode/skills/affaan-m-exa-search.md) — skill · 4500 installs

From the same set: [davila7/claude-code-templates](https://affpapa.org/en/nevibecode/by/davila7/claude-code-templates.md) — 224 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md