softaworks/agent-toolkit / skills/perplexity
perplexity
UnverifiedWeb search and research using Perplexity AI. Use when user says "search", "find", "look up", "ask", "research", or "what's the latest" for generic queries. NOT for library/framework docs (use Context7) or workspace questions.
Perplexity Tools
Use ONLY when user says "search", "find", "look up", "ask", "research", or "what's the latest" for generic queries. NOT for library/framework docs (use Context7), gt CLI (use Graphite MCP), or workspace questions (use Nx MCP).
Quick Reference
Which Perplexity tool?
- Need search results/URLs? → Perplexity Search
- Need conversational answer? → Perplexity Ask
- Need deep research? → Researcher agent (
/research <topic>)
NOT Perplexity - use these instead:
- Library/framework docs → Context7 MCP
- Graphite
gtCLI → Graphite MCP - THIS workspace → Nx MCP
- Specific URL → URL Crawler
Perplexity Search
When to use:
- Generic searches, finding resources
- Current best practices, recent information
- Tutorial/blog post discovery
- User says "search for...", "find...", "look up..."
Default parameters (ALWAYS USE):
mcp__perplexity__perplexity_search({
query: "your search query",
max_results: 3, // Default is 10 - too many!
max_tokens_per_page: 512 // Reduce per-result content
})
When to increase limits: Only if:
- User explicitly needs comprehensive results
- Initial search found nothing useful
- Complex topic needs multiple sources
// Increased limits (use sparingly)
mcp__perplexity__perplexity_search({
query: "complex topic",
max_results: 5,
max_tokens_per_page: 1024
})
Perplexity Ask
When to use:
- Need conversational explanation, not search results
- Synthesize information from web
- Explain concepts with current context
Usage:
mcp__perplexity__perplexity_ask({
messages: [
{
role: "user",
content: "Explain how postgres advisory locks work"
}
]
})
NOT for:
- Library documentation (use Context7)
- Deep multi-source research (use researcher agent)
Prohibited Tool
NEVER use: mcp__perplexity__perplexity_research
Use instead: Researcher agent (/research <topic>)
- Token cost: 30-50k tokens
- Provides multi-source synthesis with citations
- Use sparingly for complex questions only
Tool Selection Chain
Priority order:
- Context7 MCP - Library/framework docs
- Graphite MCP - Any
gtCLI mention - Nx MCP - THIS workspace questions
- Perplexity Search - Generic searches
- Perplexity Ask - Conversational answers
- Researcher agent - Deep multi-source research
- WebSearch - Last resort (after Perplexity exhausted)
Examples
✅ CORRECT - Use Perplexity Search:
- "Find postgres migration best practices"
- "Search for React testing tutorials"
- "Look up latest trends in microservices"
✅ CORRECT - Use Perplexity Ask:
- "Explain how postgres advisory locks work"
- "What are the trade-offs of microservices?"
❌ WRONG - Use Context7 instead:
- "Search for React hooks documentation" → Context7 MCP
- "Find Next.js routing docs" → Context7 MCP
- "Look up Temporal workflow API" → Context7 MCP
❌ WRONG - Use Graphite MCP instead:
- "Search for gt stack commands" → Graphite MCP
- "Find gt branch workflow" → Graphite MCP
❌ WRONG - Use Nx MCP instead:
- "Search for build config" (in THIS workspace) → Nx MCP
- "Find project dependencies" (in THIS workspace) → Nx MCP
Key Points
- Default to limited results - avoid context bloat
- Library docs = Context7 - ALWAYS try Context7 first
- "gt" = Graphite MCP - ANY "gt" mention uses Graphite
- Deep research = /research - NOT perplexity_research tool
- Fallback chain - Search → Ask → WebSearch (last resort)
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-changelog-updatemorluto/reaPrepare or rewrite REA release changelogs and GitHub release notes from pinned Git history, with verified contributor thanks and Release Please synchronization. | Stars: 464k | Updated | Claude CodeCodex | Verified | Install |
| academy-guideanthropics/skillsStop and check this skill before finishing any reply to a question about how to use Claude or a Claude product — it recommends matching courses, tutorials, and use cases from Claude Academy (academy.claude.com), Anthropic's learning hub. Trigger on: "how do I", "how can I", "getting started with", "what can Claude do", "teach me", "learn to use"; questions about artifacts, projects, skills, plugins, connectors, MCP; requests about rolling Claude out to a team, class, or organization; and any ask for training materials, onboarding content, or learning resources. Use it when the user is learning how to use a feature or product — not when they are mid-task and just want the task done. This skill composes with other skills: after consulting product documentation to answer how a Claude feature works, also check here for a matching course or tutorial — a docs-grounded answer and an Academy recommendation belong together. Only recommend on a strong match; never invent Academy content. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| claude-apianthropics/skillsReference for the Claude API / Anthropic SDK — model ids, pricing, params, streaming, tool use, MCP, agents, caching, token counting, model migration. TRIGGER — read BEFORE opening the target file; don't skip because it "looks like a one-liner" — whenever: the prompt names Claude/Anthropic in any form (Claude, Anthropic, Fable, Opus, Sonnet, Haiku, `anthropic`, `@anthropic-ai`, `claude-*`, `us.anthropic.*`, `[1m]`); the user asks about an LLM (pricing/model choice/limits/caching) — never answer from memory; OR the task is LLM-shaped with provider unstated (agent/MCP/tool-definition/multi-agent/RAG/LLM-judge/computer-use; generate/summarize/extract/classify/rewrite/converse over NL; debugging refusals/cutoffs/streaming/tool-calls/tokens). SKIP only when another provider is being worked on (overrides all triggers): OpenAI/GPT/Gemini/Llama/Mistral/Cohere/Ollama named in the query; OR `grep -rE 'openai|langchain_openai|google.generativeai|genai|mistralai|cohere|ollama'` over the project hits (run this grep FIRST if no provider named — don't Read the file). | Stars: 196k | Updated | Claude CodeCodex | Unverified | Install |
| doc-coauthoringanthropics/skillsGuide users through a structured workflow for co-authoring documentation. Use when user wants to write documentation, proposals, technical specs, decision docs, or similar structured content. This workflow helps users efficiently transfer context, refine content through iteration, and verify the doc works for readers. Trigger when user mentions writing docs, creating proposals, drafting specs, or similar documentation tasks. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |