How do I install the Perplexity skill?

Run npx skillmds@latest add javimosch/perplexity-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.

Is Perplexity safe to use?

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

Which AI agents work with Perplexity?

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 free to use?

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

Who published Perplexity?

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

Perplexity by javimosch — Agent Skill

Name: Perplexity
Author: javimosch

File contents

Perplexity Deep Search

AI-powered web search with three modes for different depth levels.

Quick Start

# Quick search (sonar) - facts, summaries, current events
{baseDir}/scripts/search.sh "latest AI news"

# Reasoning (sonar-reasoning-pro) - complex analysis, multi-step
{baseDir}/scripts/search.sh --mode reason "compare React vs Vue for enterprise apps"

# Deep Research (sonar-deep-research) - full reports, exhaustive analysis
{baseDir}/scripts/search.sh --mode research "market analysis of AI in healthcare 2025"

Modes

Mode	Model	Best For	Cost
`search` (default)	`sonar-pro`	Quick facts, summaries, current events	Low
`reason`	`sonar-reasoning-pro`	Complex analysis, comparisons, problem-solving	Medium
`research`	`sonar-deep-research`	In-depth reports, market analysis, literature reviews	High

Options

Flag	Description	Default
`--mode`	`search`, `reason`, `research`	`search`
`--recency`	`hour`, `day`, `week`, `month`	—
`--domains`	Comma-separated domain filter	—
`--lang`	Language code (`pt`, `en`, `es`, etc.)	—
`--json`	Raw JSON output	off

Examples

# Search with recency filter
{baseDir}/scripts/search.sh --recency week "OpenAI latest announcements"

# Search restricted to specific domains
{baseDir}/scripts/search.sh --domains "arxiv.org,nature.com" "transformer architecture advances"

# Search in Portuguese
{baseDir}/scripts/search.sh --lang pt "inteligência artificial no Brasil"

# Deep research with JSON output
{baseDir}/scripts/search.sh --mode research --json "enterprise AI adoption trends"

API Key

Set PERPLEXITY_API_KEY env var, or store it in a file:

mkdir -p ~/.config/perplexity
echo "your_key_here" > ~/.config/perplexity/api_key
chmod 600 ~/.config/perplexity/api_key

The script checks the env var first, then falls back to the file.

Pricing Reference

Search (sonar-pro): ~$0.01/query
Reasoning (sonar-reasoning-pro): ~$0.02/query
Deep Research (sonar-deep-research): ~$0.40/query (uses many searches + reasoning)

Use search for everyday queries. Reserve research for when you truly need exhaustive analysis.

---name: perplexity-2description: Deep search via Perplexity API. Three modes: search (quick facts), reason (complex analysis), research (in-depth reports). Returns AI-grounded answers with citations.---# Perplexity Deep SearchAI-powered web search with three modes for different depth levels.## Quick Start```bash# Quick search (sonar) - facts, summaries, current events{baseDir}/scripts/search.sh "latest AI news"# Reasoning (sonar-reasoning-pro) - complex analysis, multi-step{baseDir}/scripts/search.sh --mode reason "compare React vs Vue for enterprise apps"# Deep Research (sonar-deep-research) - full reports, exhaustive analysis{baseDir}/scripts/search.sh --mode research "market analysis of AI in healthcare 2025"```## Modes| Mode | Model | Best For | Cost ||------|-------|----------|------|| `search` (default) | `sonar-pro` | Quick facts, summaries, current events | Low || `reason` | `sonar-reasoning-pro` | Complex analysis, comparisons, problem-solving | Medium || `research` | `sonar-deep-research` | In-depth reports, market analysis, literature reviews | High |## Options| Flag | Description | Default ||------|-------------|---------|| `--mode` | `search`, `reason`, `research` | `search` || `--recency` | `hour`, `day`, `week`, `month` | — || `--domains` | Comma-separated domain filter | — || `--lang` | Language code (`pt`, `en`, `es`, etc.) | — || `--json` | Raw JSON output | off |## Examples```bash# Search with recency filter{baseDir}/scripts/search.sh --recency week "OpenAI latest announcements"# Search restricted to specific domains{baseDir}/scripts/search.sh --domains "arxiv.org,nature.com" "transformer architecture advances"# Search in Portuguese{baseDir}/scripts/search.sh --lang pt "inteligência artificial no Brasil"# Deep research with JSON output{baseDir}/scripts/search.sh --mode research --json "enterprise AI adoption trends"```## API KeySet `PERPLEXITY_API_KEY` env var, or store it in a file:```bashmkdir -p ~/.config/perplexityecho "your_key_here" > ~/.config/perplexity/api_keychmod 600 ~/.config/perplexity/api_key```The script checks the env var first, then falls back to the file.## Pricing Reference- **Search (sonar-pro):** ~$0.01/query- **Reasoning (sonar-reasoning-pro):** ~$0.02/query- **Deep Research (sonar-deep-research):** ~$0.40/query (uses many searches + reasoning)Use `search` for everyday queries. Reserve `research` for when you truly need exhaustive analysis.

Frequently asked questions

Perplexity