scooter-lacroix/perplexity-search
maestro/skills/research/perplexity-search/SKILL.md
AI-powered web search, research, and reasoning via Perplexity
$ install --global
skillsauthnpx skillsauth add scooter-lacroix/maestro perplexity-searchInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 25, 2026, 12:06 AM1.7s1 file scanned
SKILL.md
- name:
- perplexity-search
- description:
- AI-powered web search, research, and reasoning via Perplexity
- allowed-tools:
- [Bash, Read]
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/perplexity_search.py \
--ask "What is the latest version of Python?"
Direct web search (ranked results, no AI)
uv run python scripts/perplexity_search.py \
--search "SQLite graph database patterns" \
--max-results 5 \
--recency week
AI-synthesized research
uv run python scripts/perplexity_search.py \
--research "compare FastAPI vs Django for microservices"
Chain-of-thought reasoning
uv run python scripts/perplexity_search.py \
--reason "should I use Neo4j or SQLite for small graph under 10k nodes?"
Deep comprehensive research
uv run 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) |
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/perplexity_search.py \
--search "OpenTelemetry AI agent tracing" \
--recency month --max-results 5
# Get AI synthesis
uv run python scripts/perplexity_search.py \
--research "best practices for AI agent logging 2025"
# Make a decision
uv run python scripts/perplexity_search.py \
--reason "microservices vs monolith for startup MVP"
# Deep dive
uv run python scripts/perplexity_search.py \
--deep "comprehensive guide to building feedback loops for autonomous agents"
API Key Required
Requires PERPLEXITY_API_KEY in environment or ~/.maestro/.env.
Related Skills
scooter-lacroix/wiring
tools
VerifiedTrustedCommunity
Wiring Verification
5SKILL.mdUpdated Apr 12, 2026
scooter-lacroix/sub-agents
tools
VerifiedTrustedCommunity
Create and configure Maestro sub-agents with custom prompts, tools, and models
5SKILL.mdUpdated Apr 12, 2026
scooter-lacroix/slash-commands
data-ai
VerifiedTrustedCommunity
Create and use Maestro slash commands - quick prompts, bash execution, file references
5SKILL.mdUpdated Apr 12, 2026
scooter-lacroix/skill-upgrader
development
VerifiedTrustedCommunity
Upgrade any skill to v5 Hybrid format using decision theory + modal logic
5SKILL.mdUpdated Apr 12, 2026