Install skill files

Skills enable your coding agent to leverage the decision intelligence capabilities of RelationalAI. By installing the RelationalAI agent skills, your agent can understand and interact with RAI models, execute queries, perform analyses, and more — all through natural language prompts.

Before you start, make sure that:

Requires relationalai (PyRel) v1.0.14+

The RelationalAI Native App for Snowflake must be installed in your account by an administrator.

• Request access here.
• See the RAI Native App docs for details.

The rai_developer role is needed to execute PyRel programs.

Detailed install guides

Claude Code CLI

Follow these instructions to point at this repo. See this quick video for an overview.

/plugin marketplace add RelationalAI/rai-agent-skills
/plugin install rai@RelationalAI
# or use the wizard
/plugin

Restart your session after installing. To keep the plugin current, open the Plugins directory, click the ··· menu on the rai-agent-skills tile, and enable Sync automatically — it pulls new commits from the default branch without a manual step. Use Check for updates from the same menu for an on-demand refresh.

Claude Desktop

1. Click Customize in the left sidebar.
2. Next to Personal plugins, click the + button, then select Create plugin → Add marketplace.
3. In the Add marketplace dialog, enter RelationalAI/rai-agent-skills and click Sync.
4. Click + next to Personal plugins again, then select Browse plugins.
5. Open the Personal tab, find the Rai tile, and click + to install it.
6. Recommended: on the rai-agent-skills plugin tile, open the ··· menu and toggle Sync automatically on. New commits on the default branch will be pulled in without a manual update step.

Alternatively, download this repo’s contents and copy the skills into the Claude app.

VS Code / GitHub Copilot

Follow these instructions to register this repo as a plugin marketplace.

settings.json

"chat.plugins.marketplaces": [
"RelationalAI/rai-agent-skills"
]

Then open the Extensions view (⇧⌘X), search @agentPlugins, and install Rai. Updates install automatically (every 24h by default when extensions.autoUpdate is on).

Cortex Code CLI

cortex skill add RelationalAI/rai-agent-skills/plugins/rai/skills

Point Cortex at the /plugins/rai/skills subdirectory (not the repo root) — Cortex’s auto-discovery expects skills at a conventional layout and will reject the repo root otherwise. Later, run cortex skill update RelationalAI/rai-agent-skills to pull new versions.

Or follow the docs to clone the repo locally and use the /skill dialog to add the plugins/rai/skills folder.

Cortex Code (Web)

Cortex Code in the Snowflake web UI doesn’t pull directly from GitHub — you load skills from a local folder.

1. Clone the repo or download the ZIP and unzip it.
2. In Snowsight, open a workspace and launch Cortex Code from the left sidebar.
3. In the Cortex Code panel, click the + button and choose Upload Skill Folder(s).
4. Select the repo’s plugins/rai/skills/ folder (not the repo root).

To update, pull the latest changes locally (or re-download the ZIP) and upload the plugins/rai/skills/ folder again.

OpenAI Codex (CLI)

This repo ships a Codex plugin marketplace manifest at .agents/plugins/marketplace.json, so you can add it directly by GitHub shorthand:

codex plugin marketplace add RelationalAI/rai-agent-skills

Then start a Codex session and open the plugin browser:

codex

Inside the session, run the /plugins slash command, switch to the relationalai marketplace tab, and install rai. Restart the session for skills to become available.

To pull new releases later:

codex plugin marketplace upgrade relationalai

See the Codex plugins docs for more on the marketplace flow.

Cursor

This repo ships a Cursor marketplace manifest at .cursor-plugin/marketplace.json. How you install depends on your plan.

Teams / Enterprise admins. Cursor supports importing a third-party plugin marketplace from a GitHub repo:

1. Open Dashboard → Settings → Plugins.
2. Under Team Marketplaces, click Import and paste https://github.com/RelationalAI/rai-agent-skills.
3. Review the parsed plugins, assign Team Access groups, name the marketplace, and save.

Teammates then see rai in their Plugins panel and install it with one click. To pull new releases, re-import from the dashboard. Teams plans support up to 1 team marketplace; Enterprise supports unlimited.

Individual users. Cursor does not currently expose a personal marketplace-import UI, so plugin-level install isn’t available yet on free/Pro plans. As a fallback, use Remote Rules to get the skill content (without the plugin wiring):

1. Follow these instructions.
2. Paste https://github.com/RelationalAI/rai-agent-skills.git as a Remote Rule (GitHub).

Remote Rules do not auto-sync — re-import from GitHub (or git pull if you cloned into .cursor/rules/) to pick up updates.

Any coding agent (Vercel skills CLI)

Vercel’s skills CLI (requires npm v5.2.0+) manages skills across 45+ agents including Claude Code, Cursor, Codex, Copilot, Windsurf, Cline, Continue, Gemini CLI, Warp, and more.

# install all skills to all detected agents
npx skills add RelationalAI/rai-agent-skills --skill '*'

# scope to a specific agent
npx skills add RelationalAI/rai-agent-skills --skill '*' --agent cortex

# later: pull updates
npx skills update

Install from source (clone + symlink)

For power users and contributors: clone once and symlink each skill into every agent you use. Local edits and upstream git pulls both propagate instantly — no re-import step.

git clone https://github.com/RelationalAI/rai-agent-skills.git ~/src/rai-agent-skills
cd ~/src/rai-agent-skills

# link each skill into the agent's skills directory (Claude Code shown):
for d in plugins/rai/skills/*/; do
  ln -s "$PWD/$d" ~/.claude/skills/$(basename "$d")
done

Swap the target directory for other agents: ~/.agents/skills/ (Codex), ~/.cursor/rules/ (Cursor — as Remote Rules). To expose the plugin as a unit rather than loose skills, symlink the whole plugins/rai/ directory into the agent’s local-plugins location (e.g., ~/.cursor/plugins/local/rai). Run git pull inside the clone to update.