perplexity-search

by @Dunc4nJ in AI & LLM

# Install this skill:

npx skills add Dunc4nJ/agent-skills --skill "perplexity-search"

Install specific skill from multi-skill repository

# Description

AI-powered web search and research via Perplexity (Sonar models), including ranked search results and AI-synthesized answers with citations. Use for up-to-date facts, source gathering, deep research, and reasoning. Requires PERPLEXITY_API_KEY.

# SKILL.md

name: perplexity-search
description: AI-powered web search and research via Perplexity (Sonar models), including ranked search results and AI-synthesized answers with citations. Use for up-to-date facts, source gathering, deep research, and reasoning. Requires PERPLEXITY_API_KEY.
allowed-tools: [Bash, Read]

Perplexity AI Search

Run commands from this Skill folder (the directory that contains SKILL.md) so scripts/... paths resolve.

Usage

Quick question (AI answer)

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

Direct web search (ranked results, no AI)

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

AI-synthesized research

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

Chain-of-thought reasoning

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

Deep comprehensive research

uv run --with aiohttp python scripts/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)
`--max-results N`	Number of results (1-20, default: 10)
`--recency`	Filter: `day`, `week`, `month`, `year`
`--domains`	Limit to specific domains (space-separated)
`--model`	Override model selection

API key

Set PERPLEXITY_API_KEY in your environment (already configured in ~/.bashrc).

# Supported AI Coding Agents

This skill is compatible with the SKILL.md standard and works with all major AI coding agents:

⚡ Amp 🚀 Antigravity 🤖 Claude Code 🦀 Clawdbot 📝 Codex ▶️ Cursor 🤖 Droid 💎 Gemini CLI 🐙 GitHub Copilot 🪿 Goose 📊 Kilo Code 🔧 Kiro CLI 💻 OpenCode 🦘 Roo Code 🌲 Trae 🏄 Windsurf

Learn more about the SKILL.md standard and how to use these skills with your preferred AI coding agent.