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

# Openlayer Agent Skills

> Teach AI coding assistants like Claude Code and Cursor how to integrate your codebase with Openlayer.

[Agent Skills](https://github.com/anthropics/skills) are packaged instructions that
condition AI coding assistants — Claude Code, Cursor, and others — to follow a tool's
current best practices instead of guessing from memory.

The **Openlayer skill** teaches your coding agent how to wire a codebase into
Openlayer end to end:

* **Tracing / monitoring** — instrument LLM and agent code with the Python or
  TypeScript SDK and publish traces.
* **Offline evals** — set up `openlayer.json` + `tests.json`, push commits, and
  read results.
* **Tests and guardrails** — create tests from the catalog and configure
  guardrails.
* **CI/CD gating** — fail builds on eval regressions.
* **Data and docs access** — query your workspace and search the Openlayer
  documentation via the [Openlayer MCP server](/openlayer-mcp).

It covers both LLM applications and traditional/tabular ML models
(scikit-learn, XGBoost, and similar).

With the skill installed, agents stop producing outdated SDK calls, wrong
environment variables, or invented test configs — they follow the same
conventions our own team uses.

## Installation

<Tabs>
  <Tab title="Claude Code">
    ```bash theme={null}
    claude plugin marketplace add openlayer-ai/openlayer-skills
    claude plugin install openlayer@openlayer
    ```
  </Tab>

  <Tab title="Cursor">
    In the chat input:

    ```
    /add-plugin openlayer
    ```
  </Tab>

  <Tab title="Codex / Copilot / Gemini CLI / others">
    The [skills CLI](https://github.com/vercel-labs/skills) installs Agent
    Skills into most coding agents — Codex, GitHub Copilot, Gemini CLI,
    opencode, Windsurf, and dozens more. It detects the agents on your
    machine and asks which ones to install to:

    ```bash theme={null}
    npx skills add openlayer-ai/openlayer-skills --skill "openlayer"
    ```
  </Tab>

  <Tab title="claude.ai">
    Skills also work in the Claude apps: zip the
    [`skills/openlayer`](https://github.com/openlayer-ai/openlayer-skills/tree/main/skills/openlayer)
    folder and upload it under **Settings → Capabilities → Skills**. Most
    useful when Claude also has access to your code (e.g. via the
    [remote MCP connector](/openlayer-mcp) or a GitHub connection).
  </Tab>

  <Tab title="Manual">
    Any agent that reads a skills directory can use a symlink or copy:

    ```bash theme={null}
    git clone https://github.com/openlayer-ai/openlayer-skills.git
    ln -s "$(pwd)/openlayer-skills/skills/openlayer" /path/to/your/agent/skills-directory/openlayer
    ```
  </Tab>
</Tabs>

## Prerequisites

An [Openlayer account](https://app.openlayer.com) and an API key:

```bash theme={null}
export OPENLAYER_API_KEY=...
```

Find your API key under **Workspace settings → API keys** (see
[Find your API key](/workspace-and-projects/find-your-api-key)). If you run a
self-hosted Openlayer instance, also set `OPENLAYER_BASE_URL`.

## Usage

Once installed, the agent uses the skill automatically whenever a task touches
Openlayer — for example:

* "Add Openlayer tracing to this agent."
* "Set up offline evals for this repo and push a commit."
* "Create tests for hallucination and PII, and gate CI on them."

The skill source lives at
[github.com/openlayer-ai/openlayer-skills](https://github.com/openlayer-ai/openlayer-skills).