How do I install the Perplexity Search skill?

Run npx skillmds add majiayu000/perplexity-search-2 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Perplexity Search skill do?

AI-powered web search, research, and reasoning via Perplexity It is listed under AI & ML on SkillMD.

Is Perplexity Search safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Perplexity Search?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Perplexity Search free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Perplexity Search?

majiayu000 (@majiayu000) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Perplexity Search by majiayu000 — Agent Skill

Name: Perplexity Search
Rating: 4.2 (5 reviews)
Author: majiayu000

File contents

Perplexity AI Search

Web search with AI-powered answers, deep research, and chain-of-thought reasoning.

When to Use

Direct web search for ranked results (no AI synthesis)
AI-synthesized research with citations
Chain-of-thought reasoning for complex decisions
Deep comprehensive research on topics

Models (2025)

Model	Purpose
`sonar`	Lightweight search with grounding
`sonar-pro`	Advanced search for complex queries
`sonar-reasoning-pro`	Chain of thought reasoning
`sonar-deep-research`	Expert-level exhaustive research

Usage

Quick question (AI answer)

uv run python scripts/mcp/perplexity_search.py \
    --ask "What is the latest version of Python?"

Direct web search (ranked results, no AI)

uv run python scripts/mcp/perplexity_search.py \
    --search "SQLite graph database patterns" \
    --max-results 5 \
    --recency week

AI-synthesized research

uv run python scripts/mcp/perplexity_search.py \
    --research "compare FastAPI vs Django for microservices"

Chain-of-thought reasoning

uv run python scripts/mcp/perplexity_search.py \
    --reason "should I use Neo4j or SQLite for small graph under 10k nodes?"

Deep comprehensive research

uv run python scripts/mcp/perplexity_search.py \
    --deep "state of AI agent observability 2025"

Parameters

Parameter	Description
`--ask`	Quick question with AI answer (sonar)
`--search`	Direct web search - ranked results without AI synthesis
`--research`	AI-synthesized research (sonar-pro)
`--reason`	Chain-of-thought reasoning (sonar-reasoning-pro)
`--deep`	Deep comprehensive research (sonar-deep-research)

Search-specific options

Parameter	Description
`--max-results N`	Number of results (1-20, default: 10)
`--recency`	Filter: `day`, `week`, `month`, `year`
`--domains`	Limit to specific domains

Mode Selection Guide

Need	Use	Why
Quick fact	`--ask`	Fast, lightweight
Find sources	`--search`	Raw results, no AI overhead
Synthesized answer	`--research`	AI combines multiple sources
Complex decision	`--reason`	Chain-of-thought analysis
Comprehensive report	`--deep`	Exhaustive multi-source research

Examples

# Find recent sources on a topic
uv run python scripts/mcp/perplexity_search.py \
    --search "OpenTelemetry AI agent tracing" \
    --recency month --max-results 5

# Get AI synthesis
uv run python scripts/mcp/perplexity_search.py \
    --research "best practices for AI agent logging 2025"

# Make a decision
uv run python scripts/mcp/perplexity_search.py \
    --reason "microservices vs monolith for startup MVP"

# Deep dive
uv run python scripts/mcp/perplexity_search.py \
    --deep "comprehensive guide to building feedback loops for autonomous agents"

API Key Required

Requires PERPLEXITY_API_KEY in environment or ~/.claude/.env.

---name: perplexity-search-2description: AI-powered web search, research, and reasoning via Perplexity--- # Perplexity AI Search Web search with AI-powered answers, deep research, and chain-of-thought reasoning. ## When to Use - Direct web search for ranked results (no AI synthesis) - AI-synthesized research with citations - Chain-of-thought reasoning for complex decisions - Deep comprehensive research on topics ## Models (2025) | Model | Purpose | |-------|---------| | `sonar` | Lightweight search with grounding | | `sonar-pro` | Advanced search for complex queries | | `sonar-reasoning-pro` | Chain of thought reasoning | | `sonar-deep-research` | Expert-level exhaustive research | ## Usage ### Quick question (AI answer) ```bash uv run python scripts/mcp/perplexity_search.py \ --ask "What is the latest version of Python?" ``` ### Direct web search (ranked results, no AI) ```bash uv run python scripts/mcp/perplexity_search.py \ --search "SQLite graph database patterns" \ --max-results 5 \ --recency week ``` ### AI-synthesized research ```bash uv run python scripts/mcp/perplexity_search.py \ --research "compare FastAPI vs Django for microservices" ``` ### Chain-of-thought reasoning ```bash uv run python scripts/mcp/perplexity_search.py \ --reason "should I use Neo4j or SQLite for small graph under 10k nodes?" ``` ### Deep comprehensive research ```bash uv run python scripts/mcp/perplexity_search.py \ --deep "state of AI agent observability 2025" ``` ## Parameters | Parameter | Description | |-----------|-------------| | `--ask` | Quick question with AI answer (sonar) | | `--search` | Direct web search - ranked results without AI synthesis | | `--research` | AI-synthesized research (sonar-pro) | | `--reason` | Chain-of-thought reasoning (sonar-reasoning-pro) | | `--deep` | Deep comprehensive research (sonar-deep-research) | ### Search-specific options | Parameter | Description | |-----------|-------------| | `--max-results N` | Number of results (1-20, default: 10) | | `--recency` | Filter: `day`, `week`, `month`, `year` | | `--domains` | Limit to specific domains | ## Mode Selection Guide | Need | Use | Why | |------|-----|-----| | Quick fact | `--ask` | Fast, lightweight | | Find sources | `--search` | Raw results, no AI overhead | | Synthesized answer | `--research` | AI combines multiple sources | | Complex decision | `--reason` | Chain-of-thought analysis | | Comprehensive report | `--deep` | Exhaustive multi-source research | ## Examples ```bash # Find recent sources on a topic uv run python scripts/mcp/perplexity_search.py \ --search "OpenTelemetry AI agent tracing" \ --recency month --max-results 5 # Get AI synthesis uv run python scripts/mcp/perplexity_search.py \ --research "best practices for AI agent logging 2025" # Make a decision uv run python scripts/mcp/perplexity_search.py \ --reason "microservices vs monolith for startup MVP" # Deep dive uv run python scripts/mcp/perplexity_search.py \ --deep "comprehensive guide to building feedback loops for autonomous agents" ``` ## API Key Required Requires `PERPLEXITY_API_KEY` in environment or `~/.claude/.env`.

Frequently asked questions