ask-perplexity
Skill that adds /ask-perplexity to Claude Code, Codex and Cursor for source-backed web answers via the Perplexity API
Install
git clone https://github.com/Serg2000Mr/ask-perplexity-skill.git
cd ask-perplexity-skill
bash install.shAutomatic install. Codex and Cursor have separate guides in the docs folder.
This is third-party code. Review the repository files before installing.
What it does
The agent sends a question to the Perplexity Sonar API and prints the source-backed answer in chat. The model is picked by task: sonar for quick facts, sonar-pro for plan reviews, sonar-reasoning-pro for complex analysis and sonar-deep-research for large reports saved to a file. The question and materials go into separate question.md and request.json files, so multi-line text needs no escaping. The README warns about Perplexity hallucinations and gives fact-checking rules.
Who it is for. Developers who want an outside view on a plan or a quick answer about an unfamiliar API without leaving the agent.
Good fit when
- You want an outside check on an architecture decision
- You need to clarify how an unfamiliar library or format behaves
- You need a detailed research report on a topic with sources
Not a fit when
- The answer will go into code or a report without independent verification
- You have no funded Perplexity API balance: a Pro subscription does not include it
Example request
/ask-perplexity what is the latest .NET SDK version released in 2025Limitations
The API is billed separately from the subscription, per token and search request. Perplexity regularly invents CVEs, versions and flags, so every claim must be checked against the source. Rate limits depend on account tier. Scripts need python3 and curl; on Windows use Git Bash.
How to disable. Delete ~/.claude/skills/ask-perplexity and remove PERPLEXITY_API_KEY and the skill permissions from ~/.claude/settings.json.
Security check
- Requires a Perplexity API key with a paid balance
- Runs a shell script that sends data to an external API
- Code snippets included in questions are sent to Perplexity
README in short
The skill adds /ask-perplexity to Claude Code, Codex and Cursor and sends questions to the Perplexity Sonar API. The README covers getting a key, funding the balance, pricing and limits as of August 2026. The agent picks one of four Sonar models based on the task. A separate section covers typical hallucinations and verification rules. Install instructions are split into per-agent documents.
FAQ
Is a Perplexity Pro subscription enough?
No. The website and the API have separate balances, and the API must be funded on the API platform.
What if I get Argument list too long?
Use file mode: run-perplexity.sh --file /path/to/prompt.md sonar-pro.
Related
A skill that gathers the last 30 days of discussion on a topic from Reddit, X, YouTube, HN, Polymarket and GitHub into one brief
A fast Rust CLI for agent browser automation: accessibility snapshots with element refs, an MCP server and skills
Web Access
web-access
A web access skill that picks between search, page fetch and driving your own browser over CDP
MCP Server Playwright by Automata Labs
MCP Server Playwright
Playwright-based MCP server for browsing sites, clicking, filling forms, taking screenshots and running JavaScript in a browser