Skip to main content
The Relevance AI agent skills repository is a local reference that teaches your AI coding assistant how to work with Relevance AI. Clone it once and your assistant gets detailed context on agents, tools, workforces, knowledge, analytics, and evals — without needing to figure things out from scratch.
Agent skills work alongside the MCP server. The MCP server gives your assistant the ability to call Relevance AI tools. Agent skills give it the knowledge to use them well.

​
Quick start

1

Clone the agent skills repository

Choose the path that matches your AI coding assistant:
git clone https://github.com/RelevanceAI/agent-skills ~/.claude/skills/relevance-ai
2

Connect the MCP server

The agent skills provide context, but your assistant still needs the MCP server to actually interact with your Relevance AI project. Follow the setup for your client on the MCP Server page.
3

Verify the connection

Ask your AI assistant to list your agents or tools:
> List all my Relevance AI agents
If the assistant returns your agents, you’re all set.

​
What’s included

The agent skills repository contains structured reference documentation that your AI assistant reads on-demand:

SKILL.md

The main skill definition — covers all 46 MCP tools, critical usage rules, and workflow patterns your assistant should follow.

Reference docs

Detailed guides for agents, tools, workforces, knowledge, analytics, and evals that the assistant reads when working on specific tasks.

​
Topics covered

Agents

Creating agents, system prompts, actions, memory, triggers, and troubleshooting.

Tools

Building tools, transformations, OAuth configuration, versioning, and patterns.

Workforces

Multi-agent orchestration concepts, setup, and debugging.

Knowledge

Knowledge table operations — creating tables, adding rows, querying data.

Analytics

Usage metrics and reporting capabilities.

Evals

Testing agent behaviour with evaluation cases.

​
Keeping skills up to date

The agent skills repository is a standard Git repo. Pull the latest changes periodically: 
cd ~/.agents/skills/relevance-ai  # or ~/.claude/skills/relevance-ai
git pull

​
How it works

When your AI assistant encounters a Relevance AI task, it reads the relevant files from the agent skills repository to understand:
  • Which MCP tools to call — the skill definition maps tasks to specific tool names
  • What parameters to use — reference docs include required fields and correct formats
  • What pitfalls to avoid — critical rules like “always fetch full agent config before updating” prevent common mistakes
This means your assistant can handle complex workflows (like creating an agent with tools, triggers, and a system prompt) correctly on the first try, rather than through trial and error.
Agent skills follow the Agent Skills open standard. Any AI coding assistant that supports this convention can use them.