Skip to content

Install as Agent Skill

UCM is available as an Agent Skill — a lightweight, cross-platform alternative to MCP servers. No running processes, no npm packages, just a markdown file that teaches your agent how to use UCM.

Supports: Claude Code, OpenAI Codex CLI, GitHub Copilot, Cursor, VS Code, Gemini CLI, and any platform supporting the Agent Skills standard.

Why Skill over MCP?

Agent SkillMCP Server
Token cost~100 at startup10,000+ always in context
DependenciesNoneNode.js process
InstallCopy a foldernpx + config file
Platforms10+ (open standard)MCP-compatible only

Both methods give your agent full access to UCM's 50+ API endpoints. Choose Skill for minimal overhead, MCP for deeper tool integration.

Claude Code

Run these two commands one at a time in Claude Code:

Step 1 — Add the marketplace:

bash
/plugin marketplace add https://github.com/ucmai/skills.git

Step 2 — Install the skill:

bash
/plugin install ucm@ucm-marketplace

The skill is automatically loaded in all your Claude Code sessions.

Option B: Manual Install

bash
# Personal (all projects)
git clone https://github.com/ucmai/skills.git /tmp/ucm-skills
cp -r /tmp/ucm-skills/ucm ~/.claude/skills/ucm

# Project-level (shared with team)
cp -r /tmp/ucm-skills/ucm .claude/skills/ucm

OpenAI Codex CLI

bash
git clone https://github.com/ucmai/skills.git /tmp/ucm-skills
cp -r /tmp/ucm-skills/ucm ~/.agents/skills/ucm

GitHub Copilot / VS Code

bash
git clone https://github.com/ucmai/skills.git /tmp/ucm-skills

# Project level
cp -r /tmp/ucm-skills/ucm .github/skills/ucm

# Or personal level
cp -r /tmp/ucm-skills/ucm ~/.copilot/skills/ucm

Cursor

bash
git clone https://github.com/ucmai/skills.git /tmp/ucm-skills
cp -r /tmp/ucm-skills/ucm .cursor/skills/ucm

Any Agent (Generic)

Copy the ucm/ directory from github.com/ucmai/skills into your agent's skills directory, or read ucm/SKILL.md and follow the instructions.

Verify Installation

After installing, ask your agent:

"Search the web for the latest AI news using UCM"

The agent should:

  1. Detect it has the UCM skill
  2. Register if it doesn't have an API key (free, $1.00 credits)
  3. Call ucm/web-search via POST /v1/call
  4. Return the results

What's Inside

ucm/
├── SKILL.md                  # Instructions (loaded when skill activates)
├── scripts/
│   └── register.sh           # Auto-registration helper
└── references/
    └── service-catalog.md    # Full catalog of 52 endpoints
  • SKILL.md — Core instructions: when to use UCM, how to register, discover, and call services
  • scripts/register.sh — One-command registration (used by the agent, not you)
  • references/service-catalog.md — Complete service details with parameters and examples

Combining with MCP

You can use both Skill and MCP simultaneously. The skill provides lightweight guidance (when to use which service), while the MCP server provides native tool integration. They don't conflict.

Source