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 ​