# Socotra Public Skills Getting Started Guide



Prerequisites [#prerequisites]

AI Agents [#ai-agents]

Socotra public skills are compatible with any AI agent that supports remote MCP and Agent Skills, including Claude Code, Claude Cowork, Codex, and Cursor.

MCP Server [#mcp-server]

Your AI agent must be connected to the [Socotra MCP server](/ai-guide/mcp-server/overview). The MCP server can generate deployment tokens and list tenants. AI agents must have a deployment token before deploying to a tenant. Agents without access to the MCP server can still generate configurations and plugin implementations but cannot deploy to tenants.

Refer to the [MCP Server Getting Started Guide](/ai-guide/mcp-server/getting-started) for installation instructions.

Before getting started with [Socotra public skills](https://github.com/socotra/socotra-skills), you'll need a business account. You can access a business account and user credentials by navigating to [https://www.socotra.com/contact-us/](https://www.socotra.com/contact-us/) and filling out the form to speak to a representative and book a demo. Alternatively, you can send an email to [sandbox@socotra.com](mailto:sandbox@socotra.com).

Installation [#installation]

Claude Code [#claude-code]

Skills can be installed through a terminal in Claude Code or a standard terminal.

Install Skills Through a Terminal in Claude Code [#install-skills-through-a-terminal-in-claude-code]

```
/plugin marketplace add socotra/ai-configuration-skills
/plugin install socotra-skills@socotra
```

Install Skills Through a Standard Terminal [#install-skills-through-a-standard-terminal]

```
claude plugin marketplace add socotra/ai-configuration-skills
claude plugin install socotra-skills@socotra
```

Add the `--scope project` flag to share the installation with your team for a given project. If you want to experiment with skills without installing anything, clone the repository and run `claude --plugin-dir /path/to/ai-configuration-skills`.

Claude Cowork [#claude-cowork]

1. Navigate to the [Socotra Skills repository](https://github.com/socotra/socotra-skills)
2. Download the ZIP file
3. Follow the instructions [here](https://support.claude.com/en/articles/13837440-use-plugins-in-claude) to upload the ZIP file

Cursor [#cursor]

1. Navigate to the [Socotra Skills repository](https://github.com/socotra/socotra-skills)
2. Download the ZIP file
3. Copy the `skill` directory to `~/.cursor/skills/`
4. Copy the `.mdc` file to `~/.cursor/rules/`
5. Add the [Socotra MCP server configuration](/ai-guide/mcp-server/getting-started#cursor) to `~/.cursor/mcp.json`

Other AI Agents [#other-ai-agents]

Clone the [Socotra Skills repository](https://github.com/socotra/socotra-skills) and point your agent at `AGENTS.md`. This file contains the step order and the path to the rules for each step. Every file below it is in plain Markdown.

* Codex and anything else that reads AGENTS.md - Nothing to configure
* Cursor — `.cursor/rules/socotra.mdc` points at `AGENTS.md`
* Claude Code from a clone — `CLAUDE.md` points at `AGENTS.md`
* Anything else with file system access — Tell it to read `AGENTS.md` first

Next Steps [#next-steps]

* [Socotra Public Skills Example](./public-skills-example.mdx)

See Also [#see-also]

* [Socotra Public Skills Overview](./public-skills-overview)
* [MCP Server Overview](/ai-guide/mcp-server/overview)
* [Socotra Skills Repository](https://github.com/socotra/socotra-skills)