perplexity-search · dotneet — Claude Code skill: web search and research via
Adds four Perplexity API modes to your agent: quick answers, deep research, reasoning, and raw search results.
npx skills add dotneet/claude-code-marketplace --skill perplexity-search -a claude-codeWhat perplexity-search does
The skill wraps the Perplexity API in a single Python script, scripts/perplexity_api.py. Four modes sit inside: ask answers general questions on sonar-pro, research produces longer reports on sonar-deep-research, reason handles analysis on sonar-reasoning-pro, and search returns web results. The agent picks a mode from how you phrase the request.
search takes --max-results (1 to 20, default 10), --max-tokens-per-page (256 to 2048, default 1024) and --country with an ISO code. On research and reason you can pass --strip-thinking to drop thinking... tags and save context.
Set PERPLEXITY_API_KEY before the first call. Nothing runs without it, so check that first. Timeouts are raised through PERPLEXITY_TIMEOUT_MS (default 300000), and behind a proxy you set PERPLEXITY_PROXY or HTTPS_PROXY.
What it helps with
- pull fresh news on a topic without opening a browser
- collect source URLs for a write-up
- work through a hard problem step by step
- get a long report on a technical subject
- get results scoped to one country
Example prompts for the agent
- search the web for what changed in this library recently
- do deep research on vector databases and write up a report
- analyze this approach and tell me where it breaks
How to install perplexity-search
1Skills CLI (Vercel)
npx skills add dotneet/claude-code-marketplace --skill perplexity-search -a claude-code2Manually: put the files in place
~/.claude/skills/perplexity-search/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/perplexity-search/
1Skills CLI (Vercel)
npx skills add dotneet/claude-code-marketplace --skill perplexity-search -a codex2Manually: put the files in place
.agents/skills/perplexity-search/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add dotneet/claude-code-marketplace --skill perplexity-search -a cursor2Manually: put the files in place
.cursor/skills/perplexity-search/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install dotneet/claude-code-marketplace perplexity-search2Manually: put the files in place
.github/skills/perplexity-search/SKILL.md1Skills CLI (Vercel)
npx skills add dotneet/claude-code-marketplace --skill perplexity-search -a gemini-cli2Platform CLI
gemini skills install https://github.com/dotneet/claude-code-marketplace --path research/skills/perplexity-searchManually: put the files in place
.devin/skills/perplexity-search/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add dotneet/claude-code-marketplace --skill perplexity-search -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about perplexity-search
How do I install perplexity-search in Claude?
Run npx skills add dotneet/claude-code-marketplace --skill perplexity-search -a claude-code. The skill lands at ~/.claude/skills/perplexity-search/SKILL.md.
What does perplexity-search do?
It gives the agent Perplexity API access in four modes: ask, research, reason and search. Calls go through scripts/perplexity_api.py.
What does the skill need to run?
The PERPLEXITY_API_KEY environment variable and an internet connection. Behind a proxy, set PERPLEXITY_PROXY or HTTPS_PROXY.
Similar skills
All skills for Agent setup: memory, context, orchestration →perplexity-search by other authors comes first.