Agent skill

Sketchforge MCP Skill

by Formsmith746 in Formsmith746/SketchForge-3D

Control a live local SketchForge editor through its MCP server.

AGPL-3.0Auto-check passedAgent Workflows

Install Sketchforge MCP Skill

skills CLI
$ npx skills add Formsmith746/SketchForge-3D --skill sketchforge-mcp-skill -a claude-code

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

GitHub CLI
$ gh skill install Formsmith746/SketchForge-3D sketchforge-mcp-skill --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/Formsmith746/SketchForge-3D.git skills-src && mkdir -p .claude/skills && cp -r skills-src/docs/skills/sketchforge-mcp-skill .claude/skills/sketchforge-mcp-skill && 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/

Facts

Skill name
sketchforge-mcp-skill
GitHub stars
1.1k
Token cost
~1.3k tokens
SKILL.md length
587 words
Files
2
Skills in repo
1
Repo updated
First seen
Licence
AGPL-3.0

At a glance

Control a live local SketchForge editor through its MCP server.

  • Works in 3 steps: Start SketchForge from the repo → Open an editor tab at… → Configure your MCP client to start the…
  • Codex needs to list currently open SketchForge editor tabs
  • SKILL.md covers Quick Start, Client Compatibility, Targeting Editors and Core Workflow, plus 4 more sections
  • Calls npm and node

What it does

Sketchforge MCP Skill is an agent skill from Formsmith746/SketchForge-3D. Control a live local SketchForge editor through its MCP server. Use when Codex needs to list currently open SketchForge editor tabs, target a tab by editorNumber/projectName, read the current scene, list or select objects, create boxes/cubes/cylinders/sketch extrusions, update dimensions/position/rotation, align objects, group/ungroup/cut/separate parts, list exact CAD edge ids, apply chamfer/fillet to specific edges, inspect editor errors, or capture viewport images from view-cube angles.

Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `agents/openai.yaml`).

It sits in Agent Workflows, covering MCP servers. It works with Model Context Protocol. The repository describes itself as: A local-first browser 3D design editor for building, cutting, importing STL files, and exporting models. The licence is AGPL-3.0.

When your agent uses it

  • Codex needs to list currently open SketchForge editor tabs
  • Target a tab by editorNumber/projectName
  • Read the current scene
  • Create boxes/cubes/cylinders/sketch extrusions

Example prompts

  • “/sketchforge-mcp-skill”

Requirements

  • Docker

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Start SketchForge from the repo
  2. Open an editor tab at http://localhost:3000/?editor=1.
  3. Configure your MCP client to start the stdio server

What it can do on your machine

Read from SKILL.md and the folder at commit e9cb8e8. 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:

    • npm
    • node

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use npm, 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 no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Sketchforge MCP Skill loads about 1.3k tokens when it runs. Until then it costs about 129 tokens; SKILL.md has 587 words of instructions outside code blocks.

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

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 passed

The automated check found no risky patterns in SKILL.md.

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 Formsmith746/SketchForge-3D at commit e9cb8e8, republished under its AGPL-3.0 licence (© Formsmith746). 587 words, ~1,286 tokens.

Download SKILL.mdSave it as .claude/skills/sketchforge-mcp-skill/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
sketchforge-mcp-skill
description
Control a live local SketchForge editor through its MCP server. Use when Codex needs to list currently open SketchForge editor tabs, target a tab by editorNumber/projectName, read the current scene, list or select objects, create boxes/cubes/cylinders/sketch extrusions, update dimensions/position/rotation, align objects, group/ungroup/cut/separate parts, list exact CAD edge ids, apply chamfer/fillet to specific edges, inspect editor errors, or capture viewport images from view-cube angles.

SketchForge MCP

Quick Start

Use this skill only with a local SketchForge app running in development mode.

  1. Start SketchForge from the repo:
bash
npm run dev
  1. Open an editor tab at http://localhost:3000/?editor=1.

  2. Configure your MCP client to start the stdio server:

bash
node scripts/sketchforge-mcp-server.mjs

The MCP server talks to the app through /api/sketchforge-mcp. Open editor tabs heartbeat into that route and receive commands from it. Production and Docker/static builds intentionally return 404 for the MCP route.

Client Compatibility

Codex can use this folder as a skill and the MCP server as tools. Install the folder under ~/.codex/skills/sketchforge-mcp-skill and configure the MCP server in Codex.

Claude Desktop does not read Codex skills, but it can use the same scripts/sketchforge-mcp-server.mjs MCP server through Claude's mcpServers JSON config. Use the repository README for client setup examples.

Targeting Editors

Always call sketchforge_list_editors first when the user mentions multiple projects, tabs, or a number like 49536.

Use editorNumber for follow-up commands. It is a 5-digit per-tab number stored in browser sessionStorage, so two open SketchForge tabs have different numbers. The list also includes projectName, projectId, URL, shape count, selected count, notice, and last error.

If only one editor is open, commands may omit editorNumber; the server will target the sole live editor.

Core Workflow

Read scene/object state before modifying geometry:

text
sketchforge_list_editors
sketchforge_read_scene({ editorNumber })
sketchforge_list_objects({ editorNumber })

For object edits, use exact object id values from the scene. Do not invent object names; names are helpful labels only.

Useful tools:

  • sketchforge_select_objects: select ids in the live editor.
  • sketchforge_delete_objects: delete ids in the live editor, or delete the current selection when ids are omitted.
  • sketchforge_create_shape: create box, cube, cylinder, or sketch.
  • sketchforge_import_mesh: import STL-style mesh data into the editor.
  • sketchforge_update_object: set exact dimensions, position, color, name, hole state, and rotation/rotationX/rotationZ.
  • sketchforge_align_objects: align two or more ids using the same logic as the editor Alignment button.
  • sketchforge_group_objects: group selected ids using the normal SketchForge group/boolean path.
  • sketchforge_boolean_cut: pass solidIds and holeIds; the result replaces the operands.
  • sketchforge_ungroup_objects: restore grouped children while preserving edited child geometry.
  • sketchforge_separate_parts: split disconnected parts in one object.
  • sketchforge_inspect_errors: read the editor notice, edge modifier error, and last MCP error.
Show full SKILL.md (241 more words)Show less

Edge Features

Chamfer and fillet are separate edge-treatment operations in SketchForge. Do not fake a chamfer/fillet with cylinders or extra decorative geometry. Cylinders are only appropriate when the requested shape itself has a circular/rounded 2D footprint, such as rounded tray corners or a cylindrical peg.

For chamfer/fillet, never guess edge ids.

  1. Call sketchforge_list_edges({ editorNumber, id, sharpAngle }).
  2. Use returned selectableEdgeIds or inspect returned edge geometry.
  3. Call sketchforge_apply_edge_treatment({ editorNumber, id, kind, edgeIds, amount, chamferAngle }).

edgeIds can be an array of numeric ids or "all". kind is chamfer or fillet. The app commits the result through normal history, so undo/redo works.

Images

Use sketchforge_capture_image for viewport PNGs. face can be current, home, top, bottom, front, back, right, or left. These use the same camera/view-cube orientation logic as the editor UI.

Visual Verification

After creating or heavily modifying an object, use vision when available. Capture at least one useful viewport image with sketchforge_capture_image; for 3D geometry, prefer home plus any needed orthographic-style faces such as top, front, or right. Inspect the rendered result against the user's requirements before saying the task is done.

Do not rely only on numeric scene data when the user asked for a physical object. Use numeric checks for dimensions and visual checks for whether the model reads correctly.

Safety

This bridge is local-development only. If a command fails, call sketchforge_inspect_errors before retrying. For geometry operations that can be expensive, set a larger timeoutMs on the tool call.

© Formsmith746, AGPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in docs/skills/sketchforge-mcp-skill of Formsmith746/SketchForge-3D.

  • SKILL.md
  • agents/openai.yaml

Open the folder on GitHubat commit e9cb8e8

Compare with similar skills

Sketchforge MCP Skill 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.

Sketchforge MCP Skill compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Sketchforge MCP Skill this skillFormsmith746/SketchForge-3D1.1k—~1.3kAutomated safety check: PassAGPL-3.0
MCP Server Builderanthropics/skills180k63 repos~2.3kAutomated safety check: PassApache-2.0
MCP Server BuildershareAI-lab/learn-claude-code78k5 repos~1.2kAutomated safety check: PassMIT
MCP Integration for Pluginsanthropics/claude-plugins-official38k11 repos~3.1kAutomated safety check: PassApache-2.0
Crush Configurationcharmbracelet/crush29k—~3.7kAutomated safety check: PassCustom licence
Context Mode Output Sandboxmksglu/context-mode26k—~4.1kAutomated safety check: PassCustom licence

Similar skills

  • MCP Server Builder

    anthropics/skills

    Official

    Guides the design and implementation of Model Context Protocol servers in TypeScript or Python, from tool naming and error messages to evaluation.

    180k GitHub starsUsed in 63 repos~2.3k tokens
    Agent WorkflowsAuto-check passed
  • MCP Server Builder

    shareAI-lab/learn-claude-code

    Walks through building MCP servers in Python or TypeScript that expose tools, resources and prompts to Claude, with templates, registration and testing.

    78k GitHub starsUsed in 5 repos~1.2k tokens
    Agent WorkflowsAuto-check passed
  • MCP Integration for Plugins

    anthropics/claude-plugins-official

    Official

    Explains how to bundle Model Context Protocol servers in a Claude Code plugin, covering config files, stdio, SSE, HTTP and WebSocket server types, and authentication.

    38k GitHub starsUsed in 11 repos~3.1k tokens
    Agent WorkflowsAuto-check passed
  • Crush Configuration

    charmbracelet/crush

    Explains how to configure the Crush coding agent with crushrc or crush.json, covering providers, models, LSPs, MCP servers, hooks, permissions and config precedence.

    29k GitHub stars~3.7k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Context Mode Output Sandbox

    mksglu/context-mode

    Routes large command, file, API and browser output through context-mode tools so only the needed result enters the agent's context, instead of dumping it via Bash.

    26k GitHub stars~4.1k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Migrates the compatible subset of settings and global file-based MCP servers from the Warp desktop app into Warp Agent CLI without exposing credentials or state.

    65k GitHub starsUsed in 1 repo~2.1k tokens
    Agent WorkflowsAuto-check passed

Categories

Questions about Sketchforge MCP Skill

What does Sketchforge MCP Skill do?

Control a live local SketchForge editor through its MCP server. Sketchforge MCP Skill is an agent skill from Formsmith746/SketchForge-3D. Control a live local SketchForge editor through its MCP server.

When should I use Sketchforge MCP Skill?

Sketchforge MCP Skill fits situations like: Codex needs to list currently open SketchForge editor tabs; target a tab by editorNumber/projectName; read the current scene; create boxes/cubes/cylinders/sketch extrusions.

How do I install Sketchforge MCP Skill in Claude Code?

Run `npx skills add Formsmith746/SketchForge-3D --skill sketchforge-mcp-skill -a claude-code`. Or copy the skill folder (docs/skills/sketchforge-mcp-skill in Formsmith746/SketchForge-3D) into .claude/skills/sketchforge-mcp-skill in your project. Claude Code loads it when a task matches its description.

How do I install Sketchforge MCP Skill in Codex?

Run `npx skills add Formsmith746/SketchForge-3D --skill sketchforge-mcp-skill -a codex`. Or copy the skill folder (docs/skills/sketchforge-mcp-skill in Formsmith746/SketchForge-3D) into .agents/skills/sketchforge-mcp-skill in your project. Codex loads it when a task matches its description.

Can I use Sketchforge MCP Skill 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 Formsmith746/SketchForge-3D --skill sketchforge-mcp-skill -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/sketchforge-mcp-skill, .gemini/skills/sketchforge-mcp-skill, .github/skills/sketchforge-mcp-skill and .opencode/skills/sketchforge-mcp-skill in your project.

What does Sketchforge MCP Skill need to run?

Going by SKILL.md and its folder, Sketchforge MCP Skill needs the command-line tools its instructions call (npm and node). Our summary lists: Docker.

Does Sketchforge MCP Skill access the network?

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

Is Sketchforge MCP Skill safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Sketchforge MCP Skill use?

Sketchforge MCP Skill is published under the AGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Sketchforge MCP Skill use?

About 1.3k tokens (SKILL.md is roughly 5.1k 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 Sketchforge MCP Skill?

Skills that share tags, products or a category with Sketchforge MCP Skill: MCP Server Builder (anthropics/skills, 180k stars), MCP Server Builder (shareAI-lab/learn-claude-code, 78k stars), MCP Integration for Plugins (anthropics/claude-plugins-official, 38k stars) and Crush Configuration (charmbracelet/crush, 29k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Sketchforge MCP Skill?

Formsmith746 (a GitHub user) maintains it in Formsmith746/SketchForge-3D, which has 1,132 GitHub stars. The repository was last updated on September 18, 2026.

Source: Formsmith746/SketchForge-3D on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.