Agent skill

Perplexity

by davila7 in davila7/claude-code-templates

Web search and research using Perplexity AI. An agent skill from davila7/claude-code-templates.

MITAuto-check passedProductivity & Automation

Install Perplexity

skills CLI
$ npx skills add davila7/claude-code-templates --skill perplexity -a claude-code

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

GitHub CLI
$ gh skill install davila7/claude-code-templates 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/davila7/claude-code-templates.git skills-src && mkdir -p .claude/skills && cp -r skills-src/cli-tool/components/skills/ai-research/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/

Facts

Skill name
perplexity
GitHub stars
32k
Used in
2 other repos
Token cost
~965 tokens
SKILL.md length
373 words
Files
2
Skills in repo
477
Repo updated
First seen
Licence
MIT

At a glance

Web search and research using Perplexity AI. An agent skill from davila7/claude-code-templates.

  • Works in 7 steps: Context7 MCP - Library/framework docs → Graphite MCP - Any gt CLI mention → Nx MCP - THIS workspace questions → …
  • User says search
  • SKILL.md covers Quick Reference, Perplexity Search, Perplexity Ask and Prohibited Tool, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Perplexity is an agent skill from davila7/claude-code-templates. Web search and research using Perplexity AI. Use when user says "search", "find", "look up", "ask", "research", or "what's the latest" for generic queries. NOT for library/framework docs (use Context7) or workspace questions.

Its SKILL.md is about 970 tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `README.md`).

It sits in Productivity & Automation, covering Web search. It works with Perplexity and Model Context Protocol. The repository describes itself as: CLI tool for configuring and monitoring Claude Code. The licence is MIT.

When your agent uses it

  • User says search
  • Whats the latest for generic queries

Example prompts

  • “search”
  • “look up”
  • “research”
  • “/perplexity”

Workflow steps

7 steps, taken from the first numbered list in SKILL.md.

  1. Context7 MCP - Library/framework docs
  2. Graphite MCP - Any gt CLI mention
  3. Nx MCP - THIS workspace questions
  4. Perplexity Search - Generic searches
  5. Perplexity Ask - Conversational answers
  6. Researcher agent - Deep multi-source research
  7. WebSearch - Last resort (after Perplexity exhausted)

What it can do on your machine

Read from SKILL.md and the folder at commit 4c82aba. 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

    No scripts in the folder and no shell commands in SKILL.md (its code samples are typescript).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    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.

Context cost

Perplexity loads about 965 tokens when it runs. Until then it costs about 59 tokens; SKILL.md has 373 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~59
When it runs · the whole SKILL.md, loaded when a task matches
~965

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); files beside SKILL.md are not scanned.

SKILL.md

The full file from davila7/claude-code-templates at commit 4c82aba, republished under its MIT licence (© davila7). 373 words, ~965 tokens.

Download SKILL.mdSave it as .claude/skills/perplexity/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
perplexity
description
Web search and research using Perplexity AI. Use when user says "search", "find", "look up", "ask", "research", or "what's the latest" for generic queries. NOT for library/framework docs (use Context7) or workspace questions.

Perplexity Tools

Use ONLY when user says "search", "find", "look up", "ask", "research", or "what's the latest" for generic queries. NOT for library/framework docs (use Context7), gt CLI (use Graphite MCP), or workspace questions (use Nx MCP).

Quick Reference

Which Perplexity tool?

  • Need search results/URLs? → Perplexity Search
  • Need conversational answer? → Perplexity Ask
  • Need deep research? → Researcher agent (/research <topic>)

NOT Perplexity - use these instead:

  • Library/framework docs → Context7 MCP
  • Graphite gt CLI → Graphite MCP
  • THIS workspace → Nx MCP
  • Specific URL → URL Crawler

When to use:

  • Generic searches, finding resources
  • Current best practices, recent information
  • Tutorial/blog post discovery
  • User says "search for...", "find...", "look up..."

Default parameters (ALWAYS USE):

typescript
mcp__perplexity__perplexity_search({
  query: "your search query",
  max_results: 3,           // Default is 10 - too many!
  max_tokens_per_page: 512  // Reduce per-result content
})

When to increase limits: Only if:

  • User explicitly needs comprehensive results
  • Initial search found nothing useful
  • Complex topic needs multiple sources
typescript
// Increased limits (use sparingly)
mcp__perplexity__perplexity_search({
  query: "complex topic",
  max_results: 5,
  max_tokens_per_page: 1024
})

Perplexity Ask

When to use:

  • Need conversational explanation, not search results
  • Synthesize information from web
  • Explain concepts with current context

Usage:

typescript
mcp__perplexity__perplexity_ask({
  messages: [
    {
      role: "user",
      content: "Explain how postgres advisory locks work"
    }
  ]
})

NOT for:

  • Library documentation (use Context7)
  • Deep multi-source research (use researcher agent)

Prohibited Tool

NEVER use: mcp__perplexity__perplexity_research

Use instead: Researcher agent (/research <topic>)

  • Token cost: 30-50k tokens
  • Provides multi-source synthesis with citations
  • Use sparingly for complex questions only

Tool Selection Chain

Priority order:

  1. Context7 MCP - Library/framework docs
  2. Graphite MCP - Any gt CLI mention
  3. Nx MCP - THIS workspace questions
  4. Perplexity Search - Generic searches
  5. Perplexity Ask - Conversational answers
  6. Researcher agent - Deep multi-source research
  7. WebSearch - Last resort (after Perplexity exhausted)
Show full SKILL.md (138 more words)Show less

Examples

✅ CORRECT - Use Perplexity Search:

  • "Find postgres migration best practices"
  • "Search for React testing tutorials"
  • "Look up latest trends in microservices"

✅ CORRECT - Use Perplexity Ask:

  • "Explain how postgres advisory locks work"
  • "What are the trade-offs of microservices?"

❌ WRONG - Use Context7 instead:

  • "Search for React hooks documentation" → Context7 MCP
  • "Find Next.js routing docs" → Context7 MCP
  • "Look up Temporal workflow API" → Context7 MCP

❌ WRONG - Use Graphite MCP instead:

  • "Search for gt stack commands" → Graphite MCP
  • "Find gt branch workflow" → Graphite MCP

❌ WRONG - Use Nx MCP instead:

  • "Search for build config" (in THIS workspace) → Nx MCP
  • "Find project dependencies" (in THIS workspace) → Nx MCP

Key Points

  • Default to limited results - avoid context bloat
  • Library docs = Context7 - ALWAYS try Context7 first
  • "gt" = Graphite MCP - ANY "gt" mention uses Graphite
  • Deep research = /research - NOT perplexity_research tool
  • Fallback chain - Search → Ask → WebSearch (last resort)

© davila7, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in cli-tool/components/skills/ai-research/perplexity of davila7/claude-code-templates.

  • SKILL.md
  • README.md

Open the folder on GitHubat commit 4c82aba

Used in 2 other repositories

We found 7 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 2 other GitHub owners. This page covers the copy in davila7/claude-code-templates, which our catalogue first saw on October 7, 2026.

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
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Perplexity this skilldavila7/claude-code-templates32k2 repos~965Automated safety check: PassMIT
Perplexity Web MCP Bridgejacob-bd/perplexity-web-mcp195—~7.6kAutomated safety check: PassMIT
Bumblebee Hygiene ScanSzotasz/marveen115—~2.1kAutomated safety check: PassMIT
Perplexity SearchescapeWu/perplexity-ai169—~1.8kAutomated safety check: PassMIT
Browser SearchJohell1NS/browser-search528—~2.5kAutomated safety check: PassMIT
Web SearchEXboys/skilllite1703 repos~1kAutomated safety check: PassMIT

Similar skills

  • Perplexity Web MCP Bridge

    jacob-bd/perplexity-web-mcp

    Searches the web and queries premium AI models through Perplexity's own web interface, tracking quota carefully across quick, Pro and Deep Research tiers.

    195 GitHub stars~7.6k tokensUpdated 2 days ago
    Productivity & AutomationAuto-check passed
  • Bumblebee Hygiene Scan

    Szotasz/marveen

    Weekly supply-chain hygiene scan (Perplexity Bumblebee). An agent skill from Szotasz/marveen.

    115 GitHub stars~2.1k tokensUpdated yesterday
    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
  • Browser Search

    Johell1NS/browser-search

    Multi-engine web search (SearXNG) + browsing/scraping (Camofox, CloakBrowser).

    528 GitHub stars~2.5k tokensUpdated 1 mo ago
    Productivity & AutomationAuto-check passed
  • Web Search

    EXboys/skilllite

    Web search and content extraction with Tavily and Exa via inference.sh CLI.

    170 GitHub starsUsed in 3 repos~1k tokens
    Productivity & AutomationAuto-check passed
  • Huge AI Search

    wangwingzero/huge-ai-search

    Searches the live web through Google AI Mode via Huge AI Search (MCP or CLI).

    144 GitHub stars~563 tokensUpdated 1 mo ago
    Productivity & AutomationAuto-check passed

More from davila7/claude-code-templates

All 477 skills in this repo
  • 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
    Auto-check: notes
  • Neuropixels Data Analysis

    davila7/claude-code-templates

    Analyzes Neuropixels recordings from SpikeGLX or Open Ephys through preprocessing, drift correction, Kilosort4 spike sorting, quality metrics and curation.

    32k GitHub starsUsed in 10 repos~2.8k tokens
    Auto-check passed
  • Scientific Venue Templates

    davila7/claude-code-templates

    Supplies LaTeX templates and formatting rules for journals, conferences, posters, and grant proposals, then can check a draft against them.

    32k GitHub starsUsed in 9 repos~5.1k tokens
    Auto-check: notes
  • Brand Voice Content Creator

    davila7/claude-code-templates

    Analyzes a brand's existing writing to lock in a consistent voice, then builds SEO blog posts and platform-specific social content around it.

    32k GitHub starsUsed in 2 repos~1.9k tokens
    Auto-check passed
  • CAPA Officer

    davila7/claude-code-templates

    Guides corrective and preventive action (CAPA) work in a quality management system, from initiation and root cause analysis through effectiveness verification.

    32k GitHub starsUsed in 1 repo~2k tokens
    Auto-check passed
  • Fda Consultant Specialist

    davila7/claude-code-templates

    Senior FDA consultant and specialist for medical device companies including HIPAA compliance and requirement management.

    32k GitHub starsUsed in 1 repo~2.7k tokens
    Auto-check passed

Questions about Perplexity

What does Perplexity do?

Web search and research using Perplexity AI. An agent skill from davila7/claude-code-templates. Perplexity is an agent skill from davila7/claude-code-templates. Web search and research using Perplexity AI.

When should I use Perplexity?

Perplexity fits situations like: user says search; whats the latest for generic queries.

How do I install Perplexity in Claude Code?

Run `npx skills add davila7/claude-code-templates --skill perplexity -a claude-code`. Or copy the skill folder (cli-tool/components/skills/ai-research/perplexity in davila7/claude-code-templates) 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 davila7/claude-code-templates --skill perplexity -a codex`. Or copy the skill folder (cli-tool/components/skills/ai-research/perplexity in davila7/claude-code-templates) 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 davila7/claude-code-templates --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?

SKILL.md names no scripts, command-line tools or credentials: Perplexity is instructions for the agent only.

Does Perplexity access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. 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. Review the folder before installing.

What licence does Perplexity use?

Perplexity is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Perplexity use?

About 965 tokens (SKILL.md is roughly 3.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Perplexity?

Skills that share tags, products or a category with Perplexity: Perplexity Web MCP Bridge (jacob-bd/perplexity-web-mcp, 195 stars), Bumblebee Hygiene Scan (Szotasz/marveen, 115 stars), Perplexity Search (escapeWu/perplexity-ai, 169 stars) and Browser Search (Johell1NS/browser-search, 528 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Perplexity?

davila7 (a GitHub user) maintains it in davila7/claude-code-templates, which has 32,432 GitHub stars. The repository holds 477 skills in this directory. The repository was last updated on October 7, 2026.

Source: davila7/claude-code-templates on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.