How do I install the Perplexity skill?

Run npx skillmds@latest add robomotionio/perplexity in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Perplexity safe to use?

SkillMD's automated safety review verdict for this skill is PASS. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Perplexity?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Perplexity free to use?

Yes. Installing skills from SkillMD is free. This skill is licensed under Apache-2.

Who published Perplexity?

robomotionio (@robomotionio) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Perplexity by robomotionio — Agent Skill

Name: Perplexity
Author: robomotionio

Perplexity

Perplexity AI — AI-powered search and chat with real-time web data and citations. Supports web-grounded responses and conversational search via `robomotion perplexity`. Do NOT use for OpenAI, Claude, Google Search, Tavily, or other AI/search services.

robomotionio Updated Sep 17, 2026

File contents

Perplexity AI

The robomotion perplexity CLI connects to Perplexity AI for search-augmented AI responses. It provides chat completions grounded in real-time web data with source citations, combining LLM reasoning with live search results.

When to use

Search the web with AI-powered answers and citations
Run chat completions with real-time web data grounding
Get up-to-date factual responses backed by sources

Prerequisites

robomotion CLI installed
Package installed: robomotion install perplexity
Perplexity API key configured via Robomotion vault

IMPORTANT: Session Mode Required for Multi-Step Operations

Each CLI command runs as a separate process — connection IDs from connect do NOT persist across calls. You MUST use --session on connect and pass --session-id to all subsequent commands.

Workflow

Install (once): robomotion install perplexity

Connect with session:

robomotion perplexity perplexity_connect --session --output json
# → {"outClientId":"<client-id>","session_id":"<session-id>"}

Use the returned client-id and session-id in all subsequent commands:

robomotion perplexity perplexity_chat --client-id "<client-id>" --messages <json> --session-id "<session-id>" --output json

Disconnect when done:

robomotion perplexity perplexity_disconnect --client-id "<client-id>" --session-id "<session-id>" --output json

Always append --output json to get structured JSON results.

Commands Reference

robomotion perplexity perplexity_connect --session --output json Connects to Perplexity AI and returns a client ID for subsequent operations
robomotion perplexity perplexity_disconnect --client-id --session-id "<session-id>" --output json Closes the Perplexity connection and releases resources
robomotion perplexity perplexity_chat_completion --client-id --user-message --system-message --messages [--model] [--search-context-size] [--search-recency-filter] [--search-mode] [--search-domain-filter] [--max-tokens] [--temperature] [--120] --session-id "<session-id>" --output json Generates an AI response with real-time web search using Perplexity Sonar models
robomotion perplexity perplexity_search --client-id --query [--10] [--search-recency-filter] [--search-domain-filter] [--language-filter] [--country] [--60] --session-id "<session-id>" --output json Searches the web using Perplexity and returns ranked results with snippets

Environment

ROBOMOTION_API_TOKEN (if vault credentials are needed)

---name: perplexitydescription: Perplexity AI — AI-powered search and chat with real-time web data and citations. Supports web-grounded responses and conversational search via `robomotion perplexity`. Do NOT use for OpenAI, Claude, Google Search, Tavily, or other AI/search services.license: Apache-2.0---# Perplexity AIThe `robomotion perplexity` CLI connects to Perplexity AI for search-augmented AI responses. It provides chat completions grounded in real-time web data with source citations, combining LLM reasoning with live search results.## When to use- Search the web with AI-powered answers and citations- Run chat completions with real-time web data grounding- Get up-to-date factual responses backed by sources## Prerequisites- `robomotion` CLI installed- Package installed: `robomotion install perplexity`- Perplexity API key configured via Robomotion vault## IMPORTANT: Session Mode Required for Multi-Step OperationsEach CLI command runs as a **separate process** — connection IDs from `connect` do NOT persist across calls.You MUST use `--session` on `connect` and pass `--session-id` to all subsequent commands.## Workflow1. Install (once): `robomotion install perplexity`2. Connect with session: ``` robomotion perplexity perplexity_connect --session --output json # → {"outClientId":"<client-id>","session_id":"<session-id>"} ```3. Use the returned `client-id` and `session-id` in all subsequent commands: ``` robomotion perplexity perplexity_chat --client-id "<client-id>" --messages <json> --session-id "<session-id>" --output json ```4. Disconnect when done: ``` robomotion perplexity perplexity_disconnect --client-id "<client-id>" --session-id "<session-id>" --output json ```**Always** append `--output json` to get structured JSON results.## Commands Reference- `robomotion perplexity perplexity_connect --session --output json` Connects to Perplexity AI and returns a client ID for subsequent operations- `robomotion perplexity perplexity_disconnect --client-id --session-id "<session-id>" --output json` Closes the Perplexity connection and releases resources- `robomotion perplexity perplexity_chat_completion --client-id --user-message --system-message --messages [--model] [--search-context-size] [--search-recency-filter] [--search-mode] [--search-domain-filter] [--max-tokens] [--temperature] [--120] --session-id "<session-id>" --output json` Generates an AI response with real-time web search using Perplexity Sonar models- `robomotion perplexity perplexity_search --client-id --query [--10] [--search-recency-filter] [--search-domain-filter] [--language-filter] [--country] [--60] --session-id "<session-id>" --output json` Searches the web using Perplexity and returns ranked results with snippets## Environment- ROBOMOTION_API_TOKEN (if vault credentials are needed)

Frequently asked questions