Official Perplexity API Platform skills, published as portable Agent Skills. They work in Claude Code, OpenAI Codex CLI, and any other Agent Skills client, and the repository doubles as a Claude Code plugin marketplace. It will grow more Platform skills over time.
Inside Claude Code:
/plugin marketplace add perplexityai/api-platform-developers
/plugin install perplexity-platform@api-platform-developers
/reload-plugins
Or clone the repo and load the plugin directly:
claude --plugin-dir .
Invoke a skill with /perplexity-platform:migrate-sonar-to-agent-api [path].
This repository is packaged as an Agent Plugin, so clients that support the standard can install it directly from this repository. One install gets the skills and the docs MCP server; no API key is required.
Codex plugin flow (skills + docs MCP in one install): codex plugin marketplace add perplexityai/api-platform-developers, then install perplexity-platform from /plugins.
Or install skills only:
Project scope: copy or symlink skills/<name> into <your-repo>/.agents/skills/<name>.
User scope: copy or symlink skills/<name> into ~/.agents/skills/<name>.
Or use the ecosystem installers:
npx skills add perplexityai/api-platform-developers- fans out to ~70 agents.gh skill add- supports version pinning.- Codex's
$skill-installerwith this repo's GitHub URL.
Invocation in Codex: implicit by description match, or explicit with $migrate-sonar-to-agent-api.
Any agent that can fetch a URL can use a skill directly - tell it:
Read https://raw.githubusercontent.com/perplexityai/api-platform-developers/main/skills/pplx-cli/SKILL.md, install the skill, and use it for search.
(The github.com blob URL works too; the raw URL skips the HTML chrome.)
| Skill | Invoke | What it does |
|---|---|---|
| migrate-sonar-to-agent-api | /perplexity-platform:migrate-sonar-to-agent-api [path] (Claude Code) or $migrate-sonar-to-agent-api (Codex) |
Migrates a codebase from Sonar chat completions to the Agent API |
| pplx-cli | /perplexity-platform:pplx-cli [query or URL] (Claude Code) or $pplx-cli (Codex) |
Installs and uses the pplx CLI for live web search and query-relevant page snippets |
| pplx-search-sdk | /perplexity-platform:pplx-search-sdk [query or URLs] (Claude Code) or $pplx-search-sdk (Codex) |
Installs and uses the pplx-srch-sdk Python SDK for live web search, concurrent query fan-out, and query-relevant page snippets |
Skills also auto-trigger on matching context (for example, "help me migrate from Sonar") once installed.
Agents can search the live API documentation while migrating via the docs MCP server at https://docs.perplexity.ai/mcp. It is wired per client:
- Claude Code: the plugin ships it in
.mcp.json- installing the plugin is enough. Standalone:claude mcp add --transport http perplexity-docs https://docs.perplexity.ai/mcp. - Codex: installing the plugin (
codex plugin marketplace add perplexityai/api-platform-developers, then installperplexity-platformfrom/plugins) bundles it via.codex-plugin/plugin.json; the skill also declares it inagents/openai.yaml, and for skill-only installs you can add it globally in~/.codex/config.toml:
[mcp_servers.perplexity-docs]
url = "https://docs.perplexity.ai/mcp"Skills never hard-depend on it; it is a freshness upgrade, not a requirement.
The underlying API documentation lives at docs.perplexity.ai.
Licensed under the Apache License 2.0.