perplexity-web-research

name	perplexity-web-research
description	Leverage Perplexity CLI for web research, deep reasoning, and independent validation. Use when you need current/external knowledge, want a second opinion before decisions, or want to delegate complex analytical thinking to specialized reasoning models. Complements (not replaces) standard web tools. Can be invoked directly or spawned as a subagent.
license	MIT
compatibility	Requires llm CLI with llm-perplexity plugin and Perplexity API key
metadata	{"author":"Pietro Di Bello","version":"1.2.0"}
allowed-tools	Bash(llm:*)

Perplexity Web Research

Use the llm CLI with Perplexity plugin for web research, deep reasoning, and independent validation.

Quick Start

llm -m sonar 'your question here'

Model Selection

Model	Use Case	Context	Web Search
sonar	Quick lookups, general questions (default)	128k	✓
sonar-pro	Thorough answers, detailed research	200k	✓
sonar-deep-research	Complex multi-faceted research	128k	✓
sonar-reasoning	Step-by-step reasoning questions	128k	✓
sonar-reasoning-pro	Advanced reasoning with detail	128k	✓
r1-1776	Reasoning without web search	128k	✗

Start with sonar for most queries. Upgrade to other models when you need comprehensive coverage (sonar-pro), complex synthesis (sonar-deep-research), or logical reasoning (sonar-reasoning/sonar-reasoning-pro).

For detailed selection criteria, decision flowcharts, and examples, see references/model-selection-guide.md.

When to Use

Use this skill in three primary scenarios:

1. Current or External Knowledge

When you need up-to-date information and intentionally want to use Perplexity instead of standard web fetch tools:

• Documentation lookups: Current API docs, library references, framework guides
• Library versions: "What's the latest version of X?"
• Recent changes: "What changed in Y version 2.0?"
• Error research: Unfamiliar error messages or stack traces
• Technology verification: "Does X support Y feature?"
• Current events: Recent news, announcements, releases
• Fact checking: Information that may have changed since training cutoff

2. Second Opinions

When you want an independent perspective before committing to a decision or approach:

• Architecture decisions: "What are the trade-offs between approach A and B?"
• Technology choices: "Should I use X or Y for this use case?"
• Design validation: "Is this approach considered best practice?"
• Problem verification: "Am I thinking about this problem correctly?"
• Alternative perspectives: "What other ways could this be solved?"

3. Deep Reasoning Delegation

When you want to offload complex analytical thinking to specialized reasoning models (even when information doesn't need to be current):

• Complex problem solving: Multi-step reasoning requiring systematic analysis
• Algorithmic thinking: "How should I optimize this algorithm?"
• System design: "How should I architect this system?"
• Trade-off analysis: Comparing multiple options with many variables
• Mathematical reasoning: Calculations, proofs, or quantitative analysis

When NOT to Use

Do NOT use for:

• Local codebase questions: Use grep/read tools instead
• Information already in context: Use existing conversation context
• Simple factual questions: Use your training data when sufficient
• Tasks requiring file operations: Code analysis, refactoring, editing

This skill complements, not replaces, standard web tools (WebFetch, WebSearch). Choose based on whether you want Perplexity's specific capabilities (reasoning models, synthesis, alternative perspective).

Query Best Practices

Craft effective queries for better results:

• Be specific and detailed rather than vague
• Include time constraints for current information
• Specify output format when helpful
• Use domain-appropriate terminology

For comprehensive query strategies and examples, see references/query-strategies.md.

Usage Examples

Current Knowledge: Documentation Lookup

llm -m sonar 'Next.js App Router documentation 2026'

Current Knowledge: Error Research

llm -m sonar 'ECONNREFUSED error when connecting to PostgreSQL'

Current Knowledge: Library Version

llm -m sonar 'latest stable version of React 2026'

Current Knowledge: Complex Research

llm -m sonar-deep-research 'comparison of WebSocket vs Server-Sent Events for real-time updates in 2026'

Second Opinion: Architecture Decision

llm -m sonar-pro 'trade-offs between microservices and monolith for a team of 5 engineers'

Second Opinion: Technology Choice

llm -m sonar 'should I use PostgreSQL or MongoDB for a social media analytics platform'

Deep Reasoning: Algorithm Design

llm -m sonar-reasoning 'how to design an efficient caching strategy for a rate-limited API with bursty traffic patterns'

Deep Reasoning: System Architecture

llm -m sonar-reasoning-pro 'design a scalable job queue system that handles both immediate and scheduled tasks with priority levels'

Using as a Subagent

This skill can be invoked directly or spawned as a subagent for complex research tasks.

Use direct invocation for straightforward queries where results can be immediately incorporated.

Use subagent invocation when research requires multiple iterations, synthesis of findings, or can happen while you work on other tasks.

For detailed patterns and examples, see references/subagent-patterns.md.

Context Marker

When using this skill, add 🔍 as a start-of-message marker.

🔍 I will research Next.js App Router on Perplexity...

Setup

If the llm CLI or Perplexity plugin is not installed, see references/setup.md for installation instructions.

Relationship with Other Tools

This skill complements standard web tools (WebFetch, WebSearch), not replaces them.

Use Perplexity when you want:

• Specialized reasoning models for complex analysis
• Synthesis and perspective from multiple sources
• Independent validation or second opinions
• Specific Perplexity model capabilities

Use standard web tools when you want:

• Direct access to specific URLs or pages
• Raw content from known sources
• General web search without specialized reasoning