Official agent skill

Perplexity

Agent-callable Perplexity tools — ask web-grounded questions with citations, run and poll deep research, list models, and search the web.

OfficialElastic-2.0Auto-check passedProductivity & Automation

Install Perplexity

skills CLI

$ npx skills add zapier/connectors --skill perplexity -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install zapier/connectors perplexity --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/zapier/connectors.git skills-src && mkdir -p .claude/skills && cp -r skills-src/apps/perplexity .claude/skills/perplexity && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "perplexity" agent skill from https://github.com/zapier/connectors/tree/main/apps/perplexity into .claude/skills/perplexity/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "perplexity", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/zapier/connectors/tree/main/apps/perplexity

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add zapier/connectors --skill perplexity -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install zapier/connectors perplexity --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/zapier/connectors.git skills-src && mkdir -p .agents/skills && cp -r skills-src/apps/perplexity .agents/skills/perplexity && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "perplexity" agent skill from https://github.com/zapier/connectors/tree/main/apps/perplexity into .agents/skills/perplexity/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "perplexity", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add zapier/connectors --skill perplexity -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install zapier/connectors perplexity --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/zapier/connectors.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/apps/perplexity .cursor/skills/perplexity && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "perplexity" agent skill from https://github.com/zapier/connectors/tree/main/apps/perplexity into .cursor/skills/perplexity/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "perplexity", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/zapier/connectors.git --path apps/perplexity

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add zapier/connectors --skill perplexity -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install zapier/connectors perplexity --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/zapier/connectors.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/apps/perplexity .gemini/skills/perplexity && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "perplexity" agent skill from https://github.com/zapier/connectors/tree/main/apps/perplexity into .gemini/skills/perplexity/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "perplexity", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install zapier/connectors perplexity

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add zapier/connectors --skill perplexity -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/zapier/connectors.git skills-src && mkdir -p .github/skills && cp -r skills-src/apps/perplexity .github/skills/perplexity && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "perplexity" agent skill from https://github.com/zapier/connectors/tree/main/apps/perplexity into .github/skills/perplexity/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "perplexity", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add zapier/connectors --skill perplexity -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install zapier/connectors perplexity --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/zapier/connectors.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/apps/perplexity .opencode/skills/perplexity && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "perplexity" agent skill from https://github.com/zapier/connectors/tree/main/apps/perplexity into .opencode/skills/perplexity/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "perplexity", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: perplexity
GitHub stars: 176
Token cost: ~3k tokens
SKILL.md length: 979 words
Files: 33 (incl. scripts, references)
Skills in repo: 30
Repo updated: Aug 25, 2026
First seen: Oct 7, 2026
Licence: Elastic-2.0

At a glance

Agent-callable Perplexity tools — ask web-grounded questions with citations, run and poll deep research, list models, and search the web.

The user mentions Perplexity
SKILL.md covers When to use this, Setup, Scripts and Disambiguation & refusals, plus 3 more sections
Runs TypeScript and JavaScript scripts from its folder; calls npm, npx and git; reaches api.perplexity.ai
Wants a cited web answer

What it does

Perplexity is an agent skill from zapier/connectors, published by the product's own GitHub organization. Agent-callable Perplexity tools — ask web-grounded questions with citations, run and poll deep research, list models, and search the web. Use when the user mentions Perplexity or wants a cited web answer or search, even if they don't name Perplexity.

Its SKILL.md is about 3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 36 other files, including scripts and reference files (for example `.claude-plugin/plugin.json`, `.mcp.json` and `CHANGELOG.md`). Compatibility notes: Run npm install --omit=dev in this directory, then node cli.js. The TypeScript source needs Node.js 22.18+; on older Node, run cli.js for build-it-yourself /…

It sits in Productivity & Automation, covering Web search. It works with Perplexity and Zapier. The repository describes itself as: Connect your agent to the apps you already use - with or without Zapier.

When your agent uses it

The user mentions Perplexity
Wants a cited web answer
Even if they dont name Perplexity

Example prompts

“/perplexity”

Requirements

Node.js
Compatibility (from SKILL.md): Run `npm install --omit=dev` in this directory, then `node cli.js`. The TypeScript source needs Node.js 22.18+; on older Node, run `cli.js` for build-it-yourself / prebuilt / alternative-runtime options.

What it can do on your machine

Read from SKILL.md and the folder at commit e48d26f. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Ships 1 file in scripts/ (TypeScript and JavaScript, from the files we listed), which the agent can run.
Shell commands in SKILL.md call:
- npm
- npx
- git
From the folder's file list and the shell code blocks in SKILL.md.
Network
Hosts in commands or code, which the agent is likely to contact:
- api.perplexity.ai
Also links to:
- agentskills.io
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Compatibility
Run `npm install --omit=dev` in this directory, then `node cli.js`. The TypeScript source needs Node.js 22.18+; on older Node, run `cli.js` for build-it-yourself / prebuilt / alternative-runtime options.
From compatibility in the SKILL.md frontmatter.

Context cost

Perplexity loads about 3k tokens when it runs, and up to ~10k if it reads all its reference files. Until then it costs about 65 tokens; SKILL.md has 979 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~65
When it runs · the whole SKILL.md, loaded when a task matches: ~3k
With references · SKILL.md plus every file in references/, read only if the agent opens them: ~10k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

Its licence (Elastic-2.0) doesn't allow us to republish the file, so here is its outline and opening line. It has 979 words (~2,980 tokens).

“Agent-callable tools for Perplexity: ask a question and get a current, web-grounded answer with citations, poll a long-running research job, discover the available models, and run a ranked web search. Wraps the Perplexity Agent API and Search API (https://api.perplexity.ai).”

— opening of SKILL.md by zapier, Elastic-2.0

name: perplexity
compatibility: Run `npm install --omit=dev` in this directory, then `node cli.js`. The TypeScript source needs Node.js 22.18+; on older Node, run `cli.js` for build-it-yourself / prebuilt / alternative-runtime options.
license: Elastic-2.0
metadata.source: https://github.com/zapier/connectors/blob/main/apps/perplexity/SKILL.md
metadata.title: Perplexity
metadata.api-docs: https://docs.perplexity.ai
metadata.zapier-app-key: App223919CLIAPI

Read the full SKILL.md on GitHub

Files

SKILL.md and 32 other files (scripts, references) in apps/perplexity of zapier/connectors.

SKILL.md
.claude-plugin/plugin.json
.mcp.json
CHANGELOG.md
LICENSE
NOTICE
README.md
cli.js
cli.ts
connections.ts
evals/evals.json
evals/results.md
index.ts
lib/perplexity.ts
package.json
references/perplexity-api-gotchas.md
references/use-as-cli.md
… and 16 more

Open the folder on GitHubat commit e48d26f

Compare with similar skills

Perplexity next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Perplexity compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Perplexity this skillzapier/connectors	176	—	~3k	Automated safety check: Pass	Elastic-2.0	1 mo ago
Zapier Workflowsdavila7/claude-code-templates	32k	2 repos	~4.9k	Automated safety check: Pass	MIT	today
Perplexity 2sundial-org/awesome-openclaw-skills	663	—	~618	Automated safety check: Pass	None	7 mo ago
Perplexity SearchescapeWu/perplexity-ai	169	—	~1.8k	Automated safety check: Pass	MIT	10 days ago
Academic Verifyinbrainfun/inbrain	142	1 repos	~2.3k	Automated safety check: Pass	Custom licence	2 mo ago
Perplexity Search and Researchartwist-polyakov/polyakov-claude-skills	206	—	~2.5k	Automated safety check: Notes	MIT	14 days ago

Similar skills

Zapier Workflows
davila7/claude-code-templates
Manage and trigger pre-built Zapier workflows and MCP tool orchestration.
32k GitHub starsUsed in 2 repos~4.9k tokens
Productivity & AutomationAuto-check passed
Perplexity 2
sundial-org/awesome-openclaw-skills
Deep search via Perplexity API. An agent skill from sundial-org/awesome-openclaw-skills.
663 GitHub stars~618 tokensUpdated 7 mo ago
Productivity & AutomationAuto-check passed
Perplexity Search
escapeWu/perplexity-ai
Searches the live web with citations through perplexity-mcp v2 tools or a bundled Python REST client, with focused ask, deep research and detached tasks.
169 GitHub stars~1.8k tokensUpdated 10 days ago
Productivity & AutomationAuto-check passed
Academic Verify
inbrainfun/inbrain
Verify a research claim or academic citation by tracing it through publication → methodology → raw data → independent replication.
142 GitHub starsUsed in 1 repo~2.3k tokens
Productivity & AutomationAuto-check passed
Perplexity Search and Research
artwist-polyakov/polyakov-claude-skills
Shell scripts for web search and research through the Perplexity API: raw results, cited answers, background deep research and page fetching, with results cached on disk.
206 GitHub stars~2.5k tokensUpdated 14 days ago
Productivity & AutomationAuto-check: notes
Perplexity Web Search
davila7/claude-code-templates
Runs web-grounded searches through Perplexity's Sonar models over OpenRouter for current events, recent literature and cited facts beyond the model's training cutoff.
32k GitHub starsUsed in 12 repos~3.5k tokens
Research & ScienceAuto-check: notes

Questions about Perplexity

What does Perplexity do?

Agent-callable Perplexity tools — ask web-grounded questions with citations, run and poll deep research, list models, and search the web. Perplexity is an agent skill from zapier/connectors, published by the product's own GitHub organization. Agent-callable Perplexity tools — ask web-grounded questions with citations, run and poll deep research, list models, and search the web.

When should I use Perplexity?

Perplexity fits situations like: the user mentions Perplexity; wants a cited web answer; even if they dont name Perplexity.

How do I install Perplexity in Claude Code?

Run `npx skills add zapier/connectors --skill perplexity -a claude-code`. Or copy the skill folder (apps/perplexity in zapier/connectors) into .claude/skills/perplexity in your project. Claude Code loads it when a task matches its description.

How do I install Perplexity in Codex?

Run `npx skills add zapier/connectors --skill perplexity -a codex`. Or copy the skill folder (apps/perplexity in zapier/connectors) into .agents/skills/perplexity in your project. Codex loads it when a task matches its description.

Can I use Perplexity in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add zapier/connectors --skill perplexity -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/perplexity, .gemini/skills/perplexity, .github/skills/perplexity and .opencode/skills/perplexity in your project.

What does Perplexity need to run?

Going by SKILL.md and its folder, Perplexity needs TypeScript and JavaScript for the scripts in its folder and the command-line tools its instructions call (npm, npx and git). Our summary lists: Node.js. Compatibility (from SKILL.md): Run `npm install --omit=dev` in this directory, then `node cli.js`. The TypeScript source needs Node.js 22.18+; on older Node, run `cli.js` for build-it-yourself / prebuilt / alternative-runtime options..

Does Perplexity access the network?

SKILL.md names 2 domains. In commands or code: api.perplexity.ai; the agent is likely to contact it when it follows the instructions. As links in the text: agentskills.io. This is read from the text; nothing was executed.

Is Perplexity safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Perplexity use?

Perplexity is published under the Elastic-2.0 licence (declared in SKILL.md).

How many tokens does Perplexity use?

About 3k tokens (SKILL.md is roughly 12k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 7.1k tokens, read only when the agent opens those files.

What are the alternatives to Perplexity?

Skills that share tags, products or a category with Perplexity: Zapier Workflows (davila7/claude-code-templates, 32k stars), Perplexity 2 (sundial-org/awesome-openclaw-skills, 663 stars), Perplexity Search (escapeWu/perplexity-ai, 169 stars) and Academic Verify (inbrainfun/inbrain, 142 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Perplexity?

zapier (a GitHub organization, an official publisher) maintains it in zapier/connectors, which has 176 GitHub stars. The repository holds 30 skills in this directory. The repository was last updated on August 25, 2026.

Source: zapier/connectors on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Perplexity

Install Perplexity

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Compatibility

Context cost

Safety

SKILL.md

Files

Compare with similar skills

Similar skills

Zapier Workflows

Perplexity 2

Perplexity Search

Academic Verify

Perplexity Search and Research

Perplexity Web Search

More from zapier/connectors

Google Ads

Linear

Alpaca

Clay

Discord

Dropbox

Questions about Perplexity

Install Perplexity

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Compatibility

Context cost

Safety

SKILL.md

Files

Compare with similar skills

Similar skills

More from zapier/connectors

Related

Questions about Perplexity