Agent skill
perplexity
Paid research assistant with real-time web search. Use when user asks "what's the latest", "current pricing for", "recent news about", "search the web for", "fact check this", "what's new in", or needs up-to-date information beyond training data.
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/other/other/perplexity-grahama1970-agent-skills
Metadata
Additional technical details for this skill
- short description
- AI research with web search
SKILL.md
Perplexity Skill
AI-powered research assistant with real-time web search capabilities.
Prerequisites
PERPLEXITY_API_KEYin.env(get from https://www.perplexity.ai/settings/api)
When to Use
- Current information (news, recent releases, pricing)
- Technical questions requiring up-to-date docs
- Fact-checking and verification
- Research questions needing multiple sources
- Comparisons (libraries, tools, approaches)
Quick Start
# Simple query (quick answer)
python .pi/skills/perplexity/perplexity.py ask "What's new in Python 3.12?"
# With citations (JSON output)
python .pi/skills/perplexity/perplexity.py research "ArangoDB vs Neo4j for knowledge graphs"
# With specific model
python .pi/skills/perplexity/perplexity.py ask --model large "Best practices for Lean4 proofs"
Commands at a Glance
| Command | What it does | Notes |
|---|---|---|
ask |
Fast answer with short citations preview | Matches the Typer command implemented in perplexity.py ask |
research |
Full answer + citations JSON | Equivalent to calling _research() and prints JSON unless --no-json |
models |
Lists available model aliases → API IDs | Useful when wiring the skill into other agents |
Every CLI example must include the subcommand (ask, research, or models) because the Typer app requires it; omitting the subcommand will raise a usage error. The shipped SKILL docs now mirror the exact runner arguments, so you can copy/paste them without edits.
CLI Usage
Two commands: ask (quick answer) and research (with citations):
# Quick answer
python .pi/skills/perplexity/perplexity.py ask [OPTIONS] "your question"
# Research with citations (JSON output)
python .pi/skills/perplexity/perplexity.py research [OPTIONS] "your question"
Options:
--model, -m small|large|huge (default: small, fast)
--system, -s Custom system prompt
--json/--no-json JSON output (research default: --json)
Python API
# Import the internal function
from perplexity import _research
# Research with citations
result = _research("What is BM25 scoring?", model="small")
print(result["answer"])
print(result["citations"])
Note: The CLI commands ask and research are the primary interface. For Python usage, use _research() directly.
Shared Helpers
.pi/skills/dotenv_helper.pyis auto-imported so.envkeys (e.g.,PERPLEXITY_API_KEY) load without manual sourcing..pi/skills/json_utils.pyis available if you need to repair downstream JSON before writing it to files; theresearchcommand already emits valid JSON, so most callers can stream it directly.
Models
| Model | API Name | Speed | Use Case |
|---|---|---|---|
small |
sonar | Fast | Quick lookups, simple questions |
large |
sonar-pro | Medium | Technical research, comparisons |
huge |
sonar-reasoning | Slow | Complex analysis, reasoning |
Examples
Technical Research
python .pi/skills/perplexity/perplexity.py ask "How to implement hybrid search with BM25 and vector similarity?"
Current Information
python .pi/skills/perplexity/perplexity.py ask "Latest Anthropic Claude API changes 2024"
Comparison
python .pi/skills/perplexity/perplexity.py ask --model large "sentence-transformers vs OpenAI embeddings for code search"
vs Context7
| Perplexity | Context7 |
|---|---|
| General research | Library-specific docs |
| Real-time web search | Curated documentation |
| Any topic | Code libraries only |
| Synthesized answers | Raw doc snippets |
Use Context7 for: specific library API syntax, exact function signatures Use Perplexity for: research, comparisons, current information, general questions
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?