> This page location: Docs > Reference > Agent Skills > Agent Skills Installation
> Full index for agents: https://www.semantius.com/llms.txt

# Agent Skills Installation

> Install the Semantius CLI, set up credentials, and add the agent skills to your coding agent.

- **URL**: https://www.semantius.com/docs/agent-skills/installation

---

Getting Semantius **[Agent Skills](https://www.semantius.com/docs/agent-skills.md)** running takes three steps: install the Semantius CLI, set up credentials, then add the skills to your agent.

## 1. Install the Semantius CLI

The CLI is the bridge between your agent and your Semantius platform. Pick the installer for your OS.

### Linux and macOS

```bash
curl -fsSL https://raw.githubusercontent.com/semantius/semantius-cli/main/install.sh | bash
```

### Windows (PowerShell)

```bash
irm https://raw.githubusercontent.com/semantius/semantius-cli/main/install.ps1 | iex
```

The Windows installer places `semantius.exe` in `%LOCALAPPDATA%\Programs\Semantius` and adds it to your user PATH automatically. Open a fresh terminal afterwards so the updated PATH takes effect.

Verify the install by running:

```bash
semantius --version
```

## 2. Set Up Credentials

The CLI needs two values to talk to your platform: an API key and an organization name. The easiest way to get both is to ask your Ops MCP for them. Make sure the [Ops MCP connector is installed first](https://www.semantius.com/docs/mcp-connectors/installation.md), then send this prompt to your agent:

```text
I need the cli config
```

The agent calls the Ops MCP and prints back the values you need:

![Agent response showing the Semantius CLI credentials returned by the Ops MCP](https://www.semantius.com/_astro/getcliconfig.DdNDk6sz_24WO5Y.webp)

Provide them to the CLI in either of two ways. The CLI looks for a `.env` file next to the executable (Windows), in the current directory, or it picks up exported shell variables.

**Option 1: export in your shell**

```bash
export SEMANTIUS_API_KEY=your-api-key
```

```bash
export SEMANTIUS_ORG=your-org-name
```

**Option 2: `.env` file**

Drop a file named `.env` next to the executable or in the directory you run the CLI from:

```bash
SEMANTIUS_API_KEY=your-api-key
SEMANTIUS_ORG=your-org-name
```

That is all the configuration needed. The CLI automatically connects to your Semantius MCP servers (crud and cube), no separate config file required.

## 3. Install the Skills

With the CLI installed and credentials in place, pull the skill bundle into your agent. Leave the **Agent** dropdown on **All** to install for every detected agent, or pick a specific agent to target just that one. Toggle **Global** to install into your home directory instead of the current project.

```bash
npx skills add semantius/semantius-cli --all --global
```

Supports [OpenCode, Claude Code, Codex, Cursor, and 51 more](https://github.com/vercel-labs/skills#supported-agents). See the [skills documentation](https://github.com/vercel-labs/skills) to learn how to install skills for your agent.

---

The installer registers the Semantius skills (Business Analyst, Schema Editor, RBAC Configurator, Deployer, and others) with your agent. The skills call the local `semantius` binary under the hood, so the CLI you just installed is what does the actual work.

Restart your agent after installing so it picks up the new skills.

## Verify the Setup

Ask your agent something only the skills can do, for example:

> "Use the Schema Editor skill to list the entities in my platform."

If the agent invokes a Semantius skill and returns your model, everything is wired up correctly. If you get a permission error, the API key belongs to a user whose role does not allow the action: adjust the role in the admin dashboard, regenerate the key if needed, then update the credentials in your shell or `.env` file.

## Next Steps

With the skills installed, pick a starting point:

- **[Create a Model →](https://www.semantius.com/docs/models/create.md)**: build a custom semantic model from scratch with the Business Analyst skill.
- **[Templates →](https://www.semantius.com/docs/models/templates.md)**: browse curated, ready-to-use models you can deploy as-is or customize first.
- **[Deploy →](https://www.semantius.com/docs/models/deploy.md)**: ship a model file to a live Semantius instance.
- **[Optimize →](https://www.semantius.com/docs/models/optimize.md)**: pull a live module back into a markdown spec to audit and refine.

---

## Related

- [Agent Skills](https://www.semantius.com/docs/agent-skills.md)
- [CLI](https://www.semantius.com/docs/cli.md)
- [Docs home](https://www.semantius.com/docs.md)
- [Full index for agents](https://www.semantius.com/llms.txt)