Agent skill

Deployment

Deploy Memoria with Docker Compose or Kubernetes. An agent skill from matrixorigin/memoria.

Apache-2.0Auto-check: notesDevOps & Cloud

Install Deployment

skills CLI

$ npx skills add matrixorigin/memoria --skill deployment -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install matrixorigin/memoria deployment --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/matrixorigin/memoria.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/deployment .claude/skills/deployment && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "deployment" agent skill from https://github.com/matrixorigin/memoria/tree/main/skills/deployment into .claude/skills/deployment/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "deployment", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/matrixorigin/memoria/tree/main/skills/deployment

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add matrixorigin/memoria --skill deployment -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install matrixorigin/memoria deployment --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/matrixorigin/memoria.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/deployment .agents/skills/deployment && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "deployment" agent skill from https://github.com/matrixorigin/memoria/tree/main/skills/deployment into .agents/skills/deployment/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "deployment", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add matrixorigin/memoria --skill deployment -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install matrixorigin/memoria deployment --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/matrixorigin/memoria.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/deployment .cursor/skills/deployment && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "deployment" agent skill from https://github.com/matrixorigin/memoria/tree/main/skills/deployment into .cursor/skills/deployment/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "deployment", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/matrixorigin/memoria.git --path skills/deployment

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add matrixorigin/memoria --skill deployment -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install matrixorigin/memoria deployment --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/matrixorigin/memoria.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/deployment .gemini/skills/deployment && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "deployment" agent skill from https://github.com/matrixorigin/memoria/tree/main/skills/deployment into .gemini/skills/deployment/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "deployment", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install matrixorigin/memoria deployment

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add matrixorigin/memoria --skill deployment -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/matrixorigin/memoria.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/deployment .github/skills/deployment && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "deployment" agent skill from https://github.com/matrixorigin/memoria/tree/main/skills/deployment into .github/skills/deployment/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "deployment", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add matrixorigin/memoria --skill deployment -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install matrixorigin/memoria deployment --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/matrixorigin/memoria.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/deployment .opencode/skills/deployment && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "deployment" agent skill from https://github.com/matrixorigin/memoria/tree/main/skills/deployment into .opencode/skills/deployment/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "deployment", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: deployment
GitHub stars: 607
Token cost: ~1.6k tokens
SKILL.md length: 355 words
Files: 1
Skills in repo: 9
Repo updated: Oct 7, 2026
First seen: Oct 7, 2026
Licence: Apache-2.0

At a glance

Deploy Memoria with Docker Compose or Kubernetes. An agent skill from matrixorigin/memoria.

Configuring Memoria
SKILL.md covers Docker Compose (Single Instance), Environment Variables, External MatrixOne and Multi-Instance (K8s), plus 3 more sections
Calls docker and curl; needs MEMORIA_MASTER_KEY and MEMORIA_EMBEDDING_API_KEY
Tasks that involve Container orchestration

What it does

Deployment is an agent skill from matrixorigin/memoria. Deploy Memoria with Docker Compose or Kubernetes. Environment variables, multi-instance setup, security. Use when deploying or configuring Memoria.

Its SKILL.md is about 1.6k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in DevOps & Cloud, covering Container orchestration, Containers and Deployment. It works with Kubernetes, Docker and OpenAI. The repository describes itself as: Secure memory management for AI Agents • Ensures data integrity • Reduces hallucinations • Maintains consistent long-term context. The licence is Apache-2.0.

When your agent uses it

Configuring Memoria
Tasks that involve Container orchestration
Tasks that involve Containers

Example prompts

“/deployment”

Requirements

Docker
A credential in MEMORIA_MASTER_KEY
A credential in MEMORIA_EMBEDDING_API_KEY

What it can do on your machine

Read from SKILL.md and the folder at commit 81c5cc6. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
- docker
- curl
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md. Its commands use docker and curl, which can reach the network depending on how they are called.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names these keys or tokens, usually read from environment variables:
- MEMORIA_MASTER_KEY
- MEMORIA_EMBEDDING_API_KEY
- MEMORIA_API_KEY_SECRET
- API_KEY
- MASTER_KEY
- MEMORIA_DB_PASSWORD
- LLM_API_KEY
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Deployment loads about 1.6k tokens when it runs. Until then it costs about 40 tokens; SKILL.md has 355 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~40
When it runs · the whole SKILL.md, loaded when a task matches: ~1.6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

NoteMentions a .env fileSKILL.md:10

cp .env.example .env   # Set MEMORIA_MASTER_KEY, MEMORIA_EMBEDDING_API_KEY

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from matrixorigin/memoria at commit 81c5cc6, republished under its Apache-2.0 licence (© matrixorigin). 355 words, ~1,633 tokens.

Download SKILL.mdSave it as .claude/skills/deployment/SKILL.md (or your agent's skills folder).

name: deployment
description: Deploy Memoria with Docker Compose or Kubernetes. Environment variables, multi-instance setup, security. Use when deploying or configuring Memoria.

Docker Compose (Single Instance)

bash

cd Memoria
cp .env.example .env   # Set MEMORIA_MASTER_KEY, MEMORIA_EMBEDDING_API_KEY
docker compose up -d

Services: API on :8100, MatrixOne on :6001. Verify: curl http://localhost:8100/health

Environment Variables

Required

Variable	Description
`MEMORIA_MASTER_KEY`	Admin API key (min 16 chars)

Database

Variable	Default	Description
`MEMORIA_DB_HOST`	`matrixone`	MatrixOne host
`MEMORIA_DB_PORT`	`6001`	MatrixOne port
`MEMORIA_DB_USER`	`root`	Database user
`MEMORIA_DB_PASSWORD`	`111`	Database password
`MEMORIA_DB_NAME`	`memoria`	Database name

Embedding

Variable	Default	Description
`MEMORIA_EMBEDDING_PROVIDER`	`local`	`local` or `openai`
`MEMORIA_EMBEDDING_MODEL`	`all-MiniLM-L6-v2`	Model name
`MEMORIA_EMBEDDING_API_KEY`	—	Required if provider is `openai` (single-backend)
`MEMORIA_EMBEDDING_BASE_URL`	—	Custom endpoint, OpenAI-compatible (single-backend)
`MEMORIA_EMBEDDING_ENDPOINTS`	—	JSON array for multi-backend round-robin. When set, supersedes `BASE_URL`/`API_KEY`. Format: `[{"url":"https://api1.example.com/v1","api_key":"sk-1"},{"url":"https://api2.example.com/v1","api_key":"sk-2"}]`. All endpoints must serve the same model. Requests rotate round-robin; failed/rate-limited endpoints are skipped automatically.
`MEMORIA_EMBEDDING_DIM`	`0` (auto)	Embedding dimension

Distributed

Variable	Default	Description
`MEMORIA_INSTANCE_ID`	Random UUID	Unique instance ID. Set to Pod name in K8s
`MEMORIA_LOCK_TTL_SECS`	`120`	Distributed lock TTL. Heartbeat renews every TTL/3

Governance

Variable	Default	Description
`MEMORIA_GOVERNANCE_ENABLED`	`false`	Enable background governance scheduler
`MEMORIA_GOVERNANCE_PLUGIN_BINDING`	`default`	Repository binding name
`MEMORIA_GOVERNANCE_PLUGIN_SUBJECT`	`system`	Subject key for binding resolution
`MEMORIA_GOVERNANCE_PLUGIN_DIR`	—	Local plugin dir (dev mode, skips signature)

Security

Variable	Default	Description
`MEMORIA_API_KEY_SECRET`	—	HMAC secret for key hashing. Set independently of MASTER_KEY

LLM (for reflect/extract-entities/episodic)

Variable	Description
`LLM_API_KEY`	OpenAI-compatible API key
`LLM_BASE_URL`	API base URL
`LLM_MODEL`	Model name

External MatrixOne

Use an existing MatrixOne instead of the bundled one:

bash

MEMORIA_DB_HOST=your-host MEMORIA_DB_PORT=6001 docker compose up -d api

Tables are auto-created on first startup.

Show full SKILL.md (146 more words)Show less

Multi-Instance (K8s)

All coordination uses the shared MatrixOne database — zero external dependencies.

How it works:

Governance scheduler: Each instance acquires a DB lock before each task. Only one wins; others skip. Heartbeat renews every TTL/3.
Async tasks: Stored in mem_async_tasks table, visible cross-instance.
Lock expiry: Crashed instance's locks expire after TTL, another takes over.
Single-instance: NoopDistributedLock — zero overhead, identical behavior.

K8s Manifest

yaml

apiVersion: apps/v1
kind: Deployment
metadata:
  name: memoria-api
spec:
  replicas: 3
  selector:
    matchLabels:
      app: memoria-api
  template:
    metadata:
      labels:
        app: memoria-api
    spec:
      containers:
        - name: memoria
          image: matrixorigin/memoria:latest
          ports:
            - containerPort: 8100
          env:
            - name: MEMORIA_INSTANCE_ID
              valueFrom:
                fieldRef:
                  fieldPath: metadata.name
            - name: MEMORIA_MASTER_KEY
              valueFrom:
                secretKeyRef:
                  name: memoria-secrets
                  key: master-key
            - name: MEMORIA_DB_HOST
              value: "matrixone.default.svc.cluster.local"
            - name: MEMORIA_DB_PORT
              value: "6001"
            - name: MEMORIA_EMBEDDING_PROVIDER
              value: "openai"
            - name: MEMORIA_EMBEDDING_API_KEY
              valueFrom:
                secretKeyRef:
                  name: memoria-secrets
                  key: embedding-api-key
            # Optional: multi-backend round-robin (supersedes API_KEY + MODEL single-backend)
            # - name: MEMORIA_EMBEDDING_ENDPOINTS
            #   value: '[{"url":"https://api1.example.com/v1","api_key":"sk-1"},{"url":"https://api2.example.com/v1","api_key":"sk-2"}]'
            - name: MEMORIA_EMBEDDING_MODEL
              value: "BAAI/bge-m3"
            - name: MEMORIA_EMBEDDING_DIM
              value: "1024"
            - name: MEMORIA_GOVERNANCE_ENABLED
              value: "true"
            - name: MEMORIA_LOCK_TTL_SECS
              value: "120"
          livenessProbe:
            httpGet:
              path: /health
              port: 8100
            initialDelaySeconds: 5
            periodSeconds: 10
          readinessProbe:
            httpGet:
              path: /health/instance
              port: 8100
            initialDelaySeconds: 5
            periodSeconds: 10
---
apiVersion: v1
kind: Service
metadata:
  name: memoria-api
spec:
  selector:
    app: memoria-api
  ports:
    - port: 8100
      targetPort: 8100

Key points:

MEMORIA_INSTANCE_ID → fieldRef: metadata.name (Pod name)
All replicas share one MatrixOne
Leader election is automatic
Liveness: /health, Readiness: /health/instance

Data Persistence

MatrixOne data bind-mounted to ./data/matrixone. Survives restarts. Change: MATRIXONE_DATA_DIR=/your/path

Security Notes

API keys are HMAC-SHA256 hashed at rest
Set MEMORIA_API_KEY_SECRET independently of MASTER_KEY for key rotation
All queries scoped to authenticated user_id
Snapshot names are regex-validated before SQL
Rate limiting per API key (in-memory sliding window)
Run behind reverse proxy with TLS in production

Rate Limits

Configurable via env: MEMORIA_RATE_LIMIT_AUTH_KEYS=1000,60 (format: max_requests,window_seconds)

Files

Just SKILL.md in skills/deployment of matrixorigin/memoria.

Open the folder on GitHubat commit 81c5cc6

Compare with similar skills

Deployment next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Deployment compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Deployment this skillmatrixorigin/memoria	607	—	~1.6k	Automated safety check: Notes	Apache-2.0	today
LangBot Deployment Guidelangbot-app/LangBot	18k	—	~1.2k	Automated safety check: Notes	Apache-2.0	today
Debug Openshell ClusterNVIDIA/OpenShell	15k	—	~19k	Automated safety check: Notes	Apache-2.0	today
Onboarding Validationopen-edge-platform/edge-ai-suites	140	—	~3.3k	Automated safety check: Pass	Apache-2.0	yesterday
Agenticx DeployerDemonDamon/AgenticX	279	—	~866	Automated safety check: Pass	Apache-2.0	yesterday
Vss Deploy Warehouse HelmNVIDIA-AI-Blueprints/video-search-and-summarization	1.9k	—	~4.2k	Automated safety check: Pass	Apache-2.0	today

Similar skills

LangBot Deployment Guide
langbot-app/LangBot
Deploys and configures a LangBot instance with Docker Compose or Kubernetes, covering config.yaml, the Box sandbox runtime, the plugin runtime and the global API key.
18k GitHub stars~1.2k tokensUpdated today
DevOps & CloudAuto-check: notes
Debug Openshell Cluster
NVIDIA/OpenShell
Official
Debug why an OpenShell gateway deployment is unhealthy, unreachable, or unable to create sandboxes.
15k GitHub stars~19k tokensUpdated today
DevOps & CloudAuto-check: notes
Onboarding Validation
open-edge-platform/edge-ai-suites
Validate the get-started experience of Open Edge Platform (OEP) software components from the perspective of a first-time user.
140 GitHub stars~3.3k tokensUpdated yesterday
DevOps & CloudAuto-check passed
Agenticx Deployer
DemonDamon/AgenticX
Guide for deploying AgenticX agents to production including Docker containerization, Kubernetes orchestration, Volcengine AgentKit cloud deployment, and API server setup.
279 GitHub stars~866 tokensUpdated yesterday
DevOps & CloudAuto-check passed
Vss Deploy Warehouse Helm
NVIDIA-AI-Blueprints/video-search-and-summarization
A skill your agent uses when the user asks to deploy, upgrade, or size the VSS warehouse blueprint (2D / 3D / MV3DT) on Kubernetes via Helm — as opposed to Docker Compose, which is covered by…
1.9k GitHub stars~4.2k tokensUpdated today
DevOps & CloudAuto-check passed
Aspire Deployment
CommunityToolkit/Aspire
WORKFLOW SKILL — Deploy Aspire apps from AppHost models to Docker Compose, Kubernetes, Azure, AWS, or preview Radius.
629 GitHub stars~4.5k tokensUpdated today
DevOps & CloudAuto-check: notes

Questions about Deployment

What does Deployment do?

Deploy Memoria with Docker Compose or Kubernetes. An agent skill from matrixorigin/memoria. Deployment is an agent skill from matrixorigin/memoria. Deploy Memoria with Docker Compose or Kubernetes.

When should I use Deployment?

Deployment fits situations like: configuring Memoria; tasks that involve Container orchestration; tasks that involve Containers.

How do I install Deployment in Claude Code?

Run `npx skills add matrixorigin/memoria --skill deployment -a claude-code`. Or copy the skill folder (skills/deployment in matrixorigin/memoria) into .claude/skills/deployment in your project. Claude Code loads it when a task matches its description.

How do I install Deployment in Codex?

Run `npx skills add matrixorigin/memoria --skill deployment -a codex`. Or copy the skill folder (skills/deployment in matrixorigin/memoria) into .agents/skills/deployment in your project. Codex loads it when a task matches its description.

Can I use Deployment in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add matrixorigin/memoria --skill deployment -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/deployment, .gemini/skills/deployment, .github/skills/deployment and .opencode/skills/deployment in your project.

What does Deployment need to run?

Going by SKILL.md and its folder, Deployment needs the command-line tools its instructions call (docker and curl) and credentials named MEMORIA_MASTER_KEY, MEMORIA_EMBEDDING_API_KEY, MEMORIA_API_KEY_SECRET and API_KEY. Our summary lists: Docker; A credential in MEMORIA_MASTER_KEY; A credential in MEMORIA_EMBEDDING_API_KEY.

Does Deployment access the network?

SKILL.md contains no URLs. Its commands use docker and curl, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Deployment safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Deployment use?

Deployment is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Deployment use?

About 1.6k tokens (SKILL.md is roughly 6.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Deployment?

Skills that share tags, products or a category with Deployment: LangBot Deployment Guide (langbot-app/LangBot, 18k stars), Debug Openshell Cluster (NVIDIA/OpenShell, 15k stars), Onboarding Validation (open-edge-platform/edge-ai-suites, 140 stars) and Agenticx Deployer (DemonDamon/AgenticX, 279 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Deployment?

matrixorigin (a GitHub organization) maintains it in matrixorigin/memoria, which has 607 GitHub stars. The repository holds 9 skills in this directory. The repository was last updated on October 7, 2026.

Source: matrixorigin/memoria on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Deployment

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Docker Compose (Single Instance)

Environment Variables

Required

Database

Embedding

Distributed

Governance

Security

LLM (for reflect/extract-entities/episodic)

External MatrixOne

Multi-Instance (K8s)

K8s Manifest

Data Persistence

Security Notes

Rate Limits

Files

Compare with similar skills

Similar skills

More from matrixorigin/memoria

Related

Questions about Deployment