> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ceramic.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Agent Skill

> Add Ceramic web search to Claude Code, Codex, Cursor, and other coding agents with a single skill

The `ceramic-search` skill teaches your coding agent to turn questions into keyword queries, search the web with Ceramic, and answer with cited sources. It follows the open [Agent Skills](https://agentskills.io) standard, so one command installs it into [multiple supported agents](https://github.com/vercel-labs/skills#supported-agents).

<Note>
  Using Claude Code or Codex? Pick one: install this skill, **or** install the [Ceramic plugin](/mcp/ceramic-mcp), which signs in with OAuth instead of an API key. Installing both gives your agent two copies of the same skill.
</Note>

## Prerequisites

* [Node.js](https://nodejs.org), to run the installer
* A coding agent that can run shell commands
* A Ceramic API key

<Card title="Get API Key" icon="key" href="https://platform.ceramic.ai/keys" arrow="true">
  Create a Ceramic account for free to get an API key.
</Card>

## Setup

1. Set your API key in the environment your agent runs in:

   ```bash theme={null}
   export CERAMIC_API_KEY=your_api_key
   ```

2. Install the skill from your terminal:

   ```bash theme={null}
   npx skills add CeramicTeam/agent-skills
   ```

   The installer detects the coding agents on your machine and asks where to install the skill.

3. Start a new agent session and ask a question that needs current information, such as "What are the latest news headlines about the Artemis II mission?" A successful run shows an answer followed by numbered source links.

Your agent may ask for permission the first time it runs the search command.

## How the skill works

When your question needs current information, the agent:

1. Rewrites your question as a 2–8 word keyword query, since Ceramic matches exact keywords.
2. Calls the [Ceramic Search API](/api-reference/search) with your `CERAMIC_API_KEY`. If your agent also has the [Ceramic MCP server](/mcp/ceramic-mcp) connected, the skill uses the MCP tool instead.
3. Writes an answer from the results and lists the sources it used.

To update the skill later, run `npx skills update ceramic-search`.

<Columns cols={2}>
  <Card title="GitHub" icon="github" href="https://github.com/CeramicTeam/agent-skills" arrow="true">
    View source code
  </Card>

  <Card title="Search MCP" icon="plug" href="/mcp/ceramic-mcp" arrow="true">
    Connect Ceramic over MCP
  </Card>
</Columns>