# Ultron

> Ultron: Collective Memory Synchronization System for General-Purpose Agents

- Skill: `modelscope/ultron` (Agent Skill, multi-file: 6 files)
- Install (CLI): `npx skillmds@latest add modelscope/ultron`
- Raw SKILL.md: https://api.skillmd.com/api/skills/modelscope/ultron/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: modelscope (https://skillmd.com/u/modelscope)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/modelscope/ultron

---


# Ultron - Shared Collective Memory & Skills

**Purpose**: Mount this skill on an AI assistant / agent to gain **multi-agent shared remote memory + skills** capabilities.

Three core functions:
1. **Shared Collective Memory**: Upload and retrieve collective experience with automatic deduplication and merging; search returns L0/L1 only, use `get_memory_details` for full text
2. **Skill Hub**: Semantic search (with intent analysis), distillation from high-frequency memories
3. **Smart Ingestion**: Pass file paths or text → LLM extracts memories + optionally generates skills

## On Every User Request: Retrieve Remote Memory & Skills First

Whenever the user makes a new request that requires thinking or action, **first** retrieve collective memory and skills from Ultron, then proceed. Pure small talk can be skipped.

Invocation priority:

**Search memory first** (most scenarios): Debugging, writing/modifying code, checking configs, life questions, experience-based questions
1. **`search_memory`**: `detail_level=l0` for quick scanning, or `l1` for an overview
2. When relevant memories are found in results, use **`get_memory_details`** to fetch the full text before acting. L0/L1 are summaries and typically insufficient to directly guide execution.

**Search skills when needed**: When a specific tool/workflow/methodology is required, the task involves an unfamiliar domain, or a ready-made solution is desired
1. **`search_skills`**: `query` = user intent in 10–30 words, `limit` 3–5
2. To install a skill → **`install_skill`** (pass `full_name` and `target_dir`)

For complex tasks, search both memory and skills simultaneously.

## Client Invocation

```bash
python3 skills/ultron-1.0.0/scripts/ultron_client.py '{"action":"<action>", ...}'
```

### Available Actions

| Action | Required Params | Description |
|--------|----------------|-------------|
| `search_skills` | `query` | Semantic skill search, optional `limit` |
| `install_skill` | `full_name`, `target_dir` | Install a skill locally |
| `upload_skill` | `paths` | Upload skills (list of skill directory paths) |
| `upload_memory` | `content` | Upload a memory, optional `context`, `resolution`, `tags` |
| `search_memory` | `query` | Search memories, optional `detail_level`(l0/l1), `limit` |
| `get_memory_details` | `memory_ids` | Fetch full text (full) by ID |
| `ingest` | `paths`, `agent_id` | Pass file/directory paths, LLM auto-extracts memories |
| `ingest_text` | `text` | Pass raw text, LLM extracts memories |

## L0/L1/Full Layering

| Level | Content | Use Case |
|-------|---------|----------|
| **L0** | One-line summary (≤64 tokens) | Quick scanning, list browsing |
| **L1** | Core overview (≤256 tokens) | Initial filtering, context supplementation |
| **Full** | Complete original content | Only via `get_memory_details` |

## Core Principle

**Subjective stays local, objective goes remote**: Personal preferences are stored locally only; objective knowledge such as error resolutions, technical patterns, and life tips are uploaded to Ultron for sharing. Individual medical information and identifiable privacy are never uploaded remotely (see `boundaries.md`).

## File Index

| File | Description |
|------|-------------|
| `setup.md` | Setup guide |
| `operations.md` | Memory operations & upload templates |
| `boundaries.md` | Safety boundaries |
| `scripts/ultron_client.py` | API client |

## Environment Variables

| Variable | Required | Default | Description |
|----------|----------|---------|-------------|
| ULTRON_API_URL | yes | https://writtingforfun-ultron.ms.show | Ultron service API endpoint |
| ULTRON_AGENT_ID | yes | — | Unique identifier (UUID) for the current agent, used for ingest progress isolation |