AGENT SKILL

perplexity

Web 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.

License 许可
MIT
最近更新
2026-11-10
Stars
★ 1
Forks
0

01 前言 Front Matter

name
perplexity
description
Web 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.

02 资源文件 1

03 SKILL.md 正文

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 gt CLI → 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:

  1. Context7 MCP - Library/framework docs
  2. Graphite MCP - Any gt CLI mention
  3. Nx MCP - THIS workspace questions
  4. Perplexity Search - Generic searches
  5. Perplexity Ask - Conversational answers
  6. Researcher agent - Deep multi-source research
  7. 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)

04 同仓库更多 Skills

YYC-Cube
YYC-Cube/YYC3-Knowledge-Base

vercel-sandbox

Run agent-browser + Chrome inside Vercel Sandbox microVMs for browser automation from any Vercel-deployed app. Use when the user needs browser automation in a Vercel app (Next.js, SvelteKit, Nuxt, Remix, Astro, etc.), wants to run headless Chrome without binary size limits, needs persistent browser sessions across commands, or wants ephemeral isolated browser environments. Triggers include "Vercel Sandbox browser", "microVM Chrome", "agent-browser in sandbox", "browser automation on Vercel", or any task requiring Chrome in a Vercel Sandbox.

★ 1
YYC-Cube
YYC-Cube/YYC3-Knowledge-Base

slack

Interact with Slack workspaces using browser automation. Use when the user needs to check unread channels, navigate Slack, send messages, extract data, find information, search conversations, or automate any Slack task. Triggers include "check my Slack", "what channels have unreads", "send a message to", "search Slack for", "extract from Slack", "find who said", or any task requiring programmatic Slack interaction.

★ 1
YYC-Cube
YYC-Cube/YYC3-Knowledge-Base

electron

Automate Electron desktop apps (VS Code, Slack, Discord, Figma, Notion, Spotify, etc.) using agent-browser via Chrome DevTools Protocol. Use when the user needs to interact with an Electron app, automate a desktop app, connect to a running app, control a native app, or test an Electron application. Triggers include "automate Slack app", "control VS Code", "interact with Discord app", "test this Electron app", "connect to desktop app", or any task requiring automation of a native Electron application.

★ 1
YYC-Cube
YYC-Cube/YYC3-Knowledge-Base

dogfood

Systematically explore and test a web application to find bugs, UX issues, and other problems. Use when asked to "dogfood", "QA", "exploratory test", "find issues", "bug hunt", "test this app/site/platform", or review the quality of a web application. Produces a structured report with full reproduction evidence -- step-by-step screenshots, repro videos, and detailed repro steps for every issue -- so findings can be handed directly to the responsible teams.

★ 1
YYC-Cube
YYC-Cube/YYC3-Knowledge-Base

agent-browser

Browser automation CLI for AI agents. Use when the user needs to interact with websites, including navigating pages, filling forms, clicking buttons, taking screenshots, extracting data, testing web apps, or automating any browser task. Triggers include requests to "open a website", "fill out a form", "click a button", "take a screenshot", "scrape data from a page", "test this web app", "login to a site", "automate browser actions", or any task requiring programmatic web interaction.

★ 1
YYC-Cube
YYC-Cube/YYC3-Knowledge-Base

shadcn

Manages shadcn components and projects — adding, searching, fixing, debugging, styling, and composing UI, including chat interfaces. Provides project context, component docs, and usage examples. Applies when working with shadcn/ui, component registries, presets, --preset codes, or any project with a components.json file. Also triggers for "shadcn init", "create an app with --preset", "switch to --preset", and for building a design system or applying a DESIGN.md or brand spec to shadcn/ui.

★ 1