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

# Agent Skill

> Install the Galtea Agent Skill so Claude Code, Cursor, and other AI coding assistants can drive Galtea on your behalf.

> [!WARNING]
>
> You are reading the docs of Galtea 5.14. [Read this page in the latest version](https://docs.galtea.ai/sdk/integrations/agent-skill.md).

The Galtea Agent Skill is an open-source [Agent Skill](https://github.com/anthropics/skills) that teaches AI coding assistants — Claude Code, Cursor, Windsurf, and other Agent-Skills-compatible tools — how to work with Galtea. With the skill installed, your agent authenticates, discovers the right endpoints, runs evaluations, and inspects sessions and spans without you having to explain Galtea first.

Source repository: [`Galtea-AI/skills`](https://github.com/Galtea-AI/skills)

## Why use it

Without the skill, the agent improvises: it guesses endpoints, re-reads the docs from scratch, and often picks a slower path than the one Galtea recommends. With the skill loaded, the agent follows the workflows our team has already validated and sticks to the conventions encoded in the skill itself.

## Install

Install the [Galtea Agent Skill](https://github.com/Galtea-AI/skills) to let your coding agent access all Galtea features.

> [tab] Ask your coding agent
>
> Ask your coding agent to install the skill by pointing to the GitHub repository:
>
> ```
> Install the Galtea Agent Skill from github.com/Galtea-AI/skills.
> ```
>
> The agent reads the repo, picks the installation path for its own runtime (Claude Code, Cursor, Windsurf, etc.), and wires the skill up.

> [tab] Claude Code plugin
>
> Register the Galtea marketplace in Claude Code:
>
> ```
> /plugin marketplace add Galtea-AI/skills
> ```
>
> Then install the Galtea plugin:
>
> ```
> /plugin install galtea@galtea
> ```
>
> Once installed, the skill is active automatically for any Galtea-related task.

> [tab] Cursor plugin
>
> A Galtea [Cursor Plugin](https://cursor.com/docs/plugins) that bundles this skill is on the way. Once it's published to the [Cursor marketplace](https://cursor.com/marketplace), it will install the skill in a single click.
>
> > [!NOTE]
> >
> > Until the plugin is live on the marketplace, use the **Ask your coding agent** or **Manual installation** tab to install the skill in Cursor.

> [tab] Manual installation
>
> Install via npm ([skills CLI](https://github.com/anthropics/skills)):
>
> ```bash theme={"system"}
> npx skills add Galtea-AI/skills --skill "galtea"
> ```
>
> If you want to target a specific agent directly:
>
> ```bash theme={"system"}
> npx skills add Galtea-AI/skills --skill "galtea" --agent "<agent-id>"
> ```
>
> > [accordion] Alternatively, you can manually clone the skill
> >
> > Clone the repo and symlink the skill into your agent's skills directory:
> >
> > ```bash theme={"system"}
> > git clone https://github.com/Galtea-AI/skills.git /path/to/galtea-skills
> > mkdir -p ~/.claude/skills
> > ln -s /path/to/galtea-skills/skills/galtea ~/.claude/skills/galtea
> > ```
> >
> > Replace `~/.claude/skills/galtea` with your agent's skills path if you're not on Claude Code.

## Usage examples

Once installed, the agent automatically picks up the skill when the task involves Galtea. Try prompts like:

* *"Set up a new product version and connect my endpoint."*
* *"Run an evaluation for version `<id>` and show me the failures."*
* *"List the metrics linked to this product's specifications."*
* *"Analyze the poor performant evaluations from this version:  `<id>`."*
* *"Create a test for the spec I just drafted and kick off evaluations."*

The skill handles authentication, calls the right endpoints, polls async evaluations until they settle, and surfaces the results.

## Feedback

Something not working as expected, or want the skill to cover a new workflow? Open an issue on the [`Galtea-AI/skills`](https://github.com/Galtea-AI/skills/issues) repository — the agent can also do this for you via the built-in skill-feedback flow.

## Related

> [card] [Quickstart](https://docs.galtea.ai/v5.14/quickstart.md)
>
> Zero-to-first-evaluation walkthrough.

> [card] [CLI](https://docs.galtea.ai/v5.14/cli/usage.md)
>
> The `galtea` binary that the skill drives under the hood — useful to know if you ever want to run commands by hand.

> [card] [Python SDK](https://docs.galtea.ai/v5.14/sdk/installation.md)
>
> Prefer Python? Install the official SDK.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.