Socotra Public Skills Getting Started Guide

Prerequisites

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.

Your AI agent must be connected to the Socotra MCP server. 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 for installation instructions.

Before getting started with Socotra public 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/ and filling out the form to speak to a representative and book a demo. Alternatively, you can send an email to sandbox@socotra.com.

Installation

Claude Code

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

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

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

Navigate to the Socotra Skills repository
Download the ZIP file
Follow the instructions here to upload the ZIP file

Cursor

Navigate to the Socotra Skills repository
Download the ZIP file
Copy the skill directory to ~/.cursor/skills/
Copy the .mdc file to ~/.cursor/rules/
Add the Socotra MCP server configuration to ~/.cursor/mcp.json

Other AI Agents

Clone the Socotra Skills repository 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

Socotra Public Skills Example