Agent skills for driving OrcaSlicer through its MCP server, for Claude Code and Codex
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2026-11-15 00:27:06 +08:00
.claude-plugin Update the skill for the single command catalog 2026-11-14 02:56:23 +08:00
.codex-plugin Update the skill for the single command catalog 2026-11-14 02:56:23 +08:00
assets Add the Codex plugin manifest for OpenAI's plugin directory 2026-10-29 21:33:34 +08:00
skills/orcaslicer-mcp-skills update recording args 2026-11-15 00:27:06 +08:00
.gitignore Add the OrcaSlicer MCP skill as a Claude Code and Codex plugin 2026-10-29 20:20:38 +08:00
LICENSE Add the OrcaSlicer MCP skill as a Claude Code and Codex plugin 2026-10-29 20:20:38 +08:00
PRIVACY.md Add privacy policy, support and documentation links 2026-10-29 21:27:28 +08:00
README.md Update the skill to the MCP server's current tool, replay and argument names 2026-11-11 18:32:41 +08:00

OrcaSlicer MCP skills

Agent skills for OrcaSlicer, the open-source 3D printing slicer. With OrcaSlicer's MCP server connected, an AI agent such as Claude Code, Codex or opencode can load, place and arrange models, change print, filament and printer settings and presets, add supports, modifiers and multi-colour painting, use the cut, text and other gizmos, run calibration tests, model parts in the Design (CAD) tab, slice, read or export the results, run Python scripts and replays of tool calls inside OrcaSlicer, use and write OrcaSlicer plugins, and record videos of it. The skill teaches the agent the tool calls that work, the settings whose meaning their label hides, and the traps that otherwise cost retries, so tasks finish in fewer calls and with fewer screenshots.

It also covers developing OrcaSlicer itself: launching a build with MCP, reproducing an issue, and recording replays for tests.

Before you start

Open OrcaSlicer, turn on Preferences > General > AI features > MCP server, and use Add to an agent to copy the setup for your agent. The skill does nothing until the agent is connected to a running OrcaSlicer.

Install

Claude Code

claude plugin marketplace add OrcaSlicer/orcaslicer-mcp-skills
claude plugin install orcaslicer-mcp-skills@orcaslicer

Update later with claude plugin update orcaslicer-mcp-skills@orcaslicer.

Codex

codex plugin marketplace add OrcaSlicer/orcaslicer-mcp-skills
codex plugin add orcaslicer-mcp-skills@orcaslicer

Update later with codex plugin marketplace upgrade orcaslicer, then run the codex plugin add command again.

opencode

opencode has no plugin marketplace, so it takes the skill as a folder. Clone this repository and copy the skill into ~/.config/opencode/skills:

git clone https://github.com/OrcaSlicer/orcaslicer-mcp-skills.git
mkdir -p ~/.config/opencode/skills && cp -R orcaslicer-mcp-skills/skills/orcaslicer-mcp-skills ~/.config/opencode/skills/

On Windows, in PowerShell:

New-Item -ItemType Directory -Force "$HOME\.config\opencode\skills" | Out-Null; Copy-Item -Recurse orcaslicer-mcp-skills\skills\orcaslicer-mcp-skills "$HOME\.config\opencode\skills\"

opencode also reads ~/.claude/skills and ~/.agents/skills, so a manual install there (below) already reaches it; keep the skill in one of these folders only. A Claude Code or Codex plugin install doesn't reach opencode. Restart opencode after installing; to update, git pull in the clone and copy the folder again.

Manual install

Copy the skill folder into your agent's skills folder: ~/.claude/skills for Claude Code, ~/.agents/skills for Codex and other agents that read it. On macOS and Linux:

git clone https://github.com/OrcaSlicer/orcaslicer-mcp-skills.git
mkdir -p ~/.claude/skills && cp -R orcaslicer-mcp-skills/skills/orcaslicer-mcp-skills ~/.claude/skills/
mkdir -p ~/.agents/skills && cp -R orcaslicer-mcp-skills/skills/orcaslicer-mcp-skills ~/.agents/skills/

On Windows, in PowerShell:

New-Item -ItemType Directory -Force "$HOME\.claude\skills" | Out-Null; Copy-Item -Recurse orcaslicer-mcp-skills\skills\orcaslicer-mcp-skills "$HOME\.claude\skills\"

To update, git pull in the clone and copy the folder again. Start a new agent session after installing or updating.

Use

Ask for what you want done in OrcaSlicer, for example "load benchy.stl, scale it to 150 %, slice it with 0.16 mm layers and tell me the print time and filament weight". The agent loads the skill when OrcaSlicer's MCP tools are available or the request is about OrcaSlicer.

What it runs

The plugin is instructions only: one skill with its reference files. It installs no MCP server, runs no code of its own and sends nothing anywhere. The agent works through the OrcaSlicer MCP connection you set up, which accepts connections from your own computer only. See the privacy policy.

Releasing

Raise version in .claude-plugin/plugin.json and .codex-plugin/plugin.json with every release; Claude Code and Codex installs update only when it changes. The Codex manifest also carries the OpenAI plugin directory listing and marks the plugin desktop-only, since it needs OrcaSlicer running on the same computer. Check the plugin with claude plugin validate --strict . before pushing.

License

AGPL-3.0, the same as OrcaSlicer.