RobotRegistryFoundation

Robot Md — Development skill for Claude Code

Development community

ROBOT.md — a single self-describing file so any agent can safely operate your robot.

How to install Robot Md

This entry records only its repository, not the path inside it, so there is no exact command to give. Open RobotRegistryFoundation/robot-md and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Robot Md does

ROBOT.md — a single self-describing file so any agent can safely operate your robot.

Alternatives in Development

Auto — Smart router - Single entry point with natural language intent detection 2.8k ★
Codexmcp — Enable seamless collaboration between Claude Code and Codex, transforming from a single agent to multiple agen 2k ★
Vibekit — A simple SDK for safely running Codex, Gemini CLI, and Claude Code in a secure sandbox 1.7k ★

README

robot-md

**`ROBOT.md` is to a robot what `CLAUDE.md` is to a codebase.** One file — YAML frontmatter + markdown prose — so Claude Code, Claude Desktop, Cursor, Zed, Gemini CLI, or any MCP-aware agent can safely operate your robot.

**Peer runtime:** `robot-md` and [`opencastor`](https://github.com/craigm26/OpenCastor) are first-class peer RCAN 3.x runtimes against a single `ROBOT.md` — see [PEER_RUNTIMES.md](https://github.com/craigm26/opencastor-ops/blob/master/PEER_RUNTIMES.md) for the side-by-side comparison.

[![PyPI](https://img.shields.io/pypi/v/robot-md.svg)](https://pypi.org/project/robot-md/) [![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE) [![Spec](https://img.shields.io/badge/spec-live%20matrix-green.svg)](https://rcan.dev/compatibility) [![RCAN](https://img.shields.io/badge/RCAN-protocol-blue.svg)](https://rcan.dev/compatibility)

Where this fits in the stack

This repo is the **declaration layer** — the file format + Python CLI. Everything else is independent; adopt one, or all seven.

Layer	Piece	What it is
Declaration ← this	ROBOT.md	The file a robot ships at its root. YAML frontmatter + markdown prose. Declares identity, capabilities, safety gates. Spec + `robot-md` Python CLI (`init`, `validate`, `render`, `calibrate`, `register`, `autodetect`).
Agent bridge	robot-md-mcp	MCP server that exposes a `ROBOT.md` to Claude Code, Claude Desktop, Cursor, Zed, Gemini CLI — any MCP-aware agent. One `claude mcp add` away.
Gateway / Enforcement (Layer 3)	robot-md-gateway	Mandatory exclusive path between agent intent and any actuator. Receives signed RCAN INVOKE envelopes, verifies manifest provenance, applies tier policy + tool allowlist, dispatches to drivers, signs an audit-bundle