guoleizhen717/solidworks-api-skill

Latest recorded source activity: May 20, 2026 at 14:49

SkillsMP catalog refreshed: November 12, 2026 at 12:52

skills collected: 1

GitHub stars: 5
GitHub forks: 0

Install with an AI assistant

Copy this prompt into the AI assistant you're using.

Follow https://skillsmp.com/skill-install/prompt.md to install Agent Skills from https://github.com/guoleizhen717/solidworks-api-skill.

Repository README

Repository README source: README.md

Read the source README

Expand full README

# SolidWorks API Skill for Claude Code [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) [![Claude Code](https://img.shields.io/badge/Claude%20Code-Skill-blue)](https://claude.ai/code) [![SolidWorks](https://img.shields.io/badge/SolidWorks-2023-orange)](https://www.solidworks.com/) A Claude Code skill that teaches AI coding agents how to write correct SolidWorks API/SDK automation code. Covers part modeling, sketches, features (extrude/revolve/cut), patterns, mates, materials, STEP export, and specialized shield machine cutterhead design workflows. ## Why This Skill Exists SolidWorks API methods have **10-15 parameters each**, with mixed types (bool/double/string). Without guidance, AI agents frequently: - Guess parameter counts (causing COM errors) - Use wrong units (SolidWorks API uses **meters**, not mm) - Hardcode magic numbers instead of `swConst` enums - Hit late-binding limitations (>12 params fail via IDispatch) This skill encodes the patterns, constants, and gotchas discovered during a real shield machine cutterhead modeling project, saving you hours of debugging COM errors. ## Quick Install ### Claude Code ```bash # Copy to your Claude Code skills directory cp SKILL.md ~/.claude/skills/solidworks-api/SKILL.md ``` Or install via Claude Code marketplace: ``` /plugin marketplace add guoleizhen717/solidworks-api-skill ``` ### Codex CLI ```bash # Copy to your Codex skills directory cp SKILL.md ~/.codex/skills/solidworks-api/SKILL.md ``` ### Manual (Any AI Coding Agent) Simply include `SKILL.md` in your project. Most agents (Claude Code, Codex, Cursor, Copilot) will pick it up from the repo root. ## What's Covered | Area | Methods Covered | |------|----------------| | **Connection** | `ISldWorks`, `Dispatch`, `Visible` | | **Documents** | `NewDocument`, `NewPart`, templates | | **Sketches** | `InsertSketch2`, `CreateCircle`, `CreateLine`, `CreateCornerRectangle` | | **Features** | `FeatureExtrusion2`, `FeatureRevolve2`, `FeatureCut4`, `FeatureFillet3`, `FeatureChamfer3` | | **Patterns** | `FeatureCircularPattern4`, `FeatureLinearPattern4`, `FeatureMirror2` | | **References** | `InsertRefPlane`, `FeatureShell` | | **Export** | `SaveAs3` (STEP, SLDPRT) | | **Constants** | `swDocPART`, `swEndCondBlind`, `swPlaneTop`, etc. | | **Units** | Meters internal ↔ mm conversion (`MM_TO_METERS = 0.001`) | ## Cutterhead Modeling Domain Specialized guidance for shield machine (盾构机) cutterhead design: - **Face plate** — large diameter disc (φ6–15m), 400–800mm thick - **Spokes/arms** — radial distribution, 4–8 arms, rectangular cross-section - **Cutter mounts** — circular pattern distribution - **Scrapers/rippers** — edge and center placement - **Soil discharge slots** — through-cut operations - **Mounting flange** — center connection structure ## Known COM Limitations This skill documents the following late-binding (IDispatch) limitations discovered through testing: | Issue | Details | Workaround | |-------|---------|------------| | `FeatureExtrusion2` fails | >12 required params, COM late-binding rejects | Use VBA macro (.swp) with early binding | | `RecordMacro` unavailable | Not exposed via IDispatch in SW 2023 | Pre-create blank .swp macro manually | | `SelectByID2` Callout param | Type mismatch in winax (Node.js) | Use `FeatureByName()` + `Select2()` | | Chinese plane names | 前视/上视/右视基准面 | Always use `FeatureByName("Plane")` | ## File Structure ``` solidworks-api-skill/ ├── SKILL.md # Main skill definition with frontmatter ├── README.md # This file ├── CLAUDE.md # Instructions for Claude/Codex about this repo └── LICENSE # MIT ``` ## Prerequisites - SolidWorks 2023 (or compatible version) - Python with `pywin32` (for Python COM automation) - Node.js with `solidworks-mcp-server` (for MCP-based automation) - Understanding that **SolidWorks API uses meters internally** (1 mm = 0.001 m) ## License MIT — see [LICENSE](LICENSE) for details. ## Author Created and maintained by [@guoleizhen717](https://github.com/guoleizhen717). Built during a shield machine cutterhead (盾构机刀盘) automation project with SolidWorks 2023.

Loading the repository README…

Skills in this repository

Software Developers

1 occupation category · 100% classified

skill

occupation

description

updated

solidworks-api

Software Developers

SolidWorks 2023 API/SDK coding assistant. Covers part modeling, sketches, features (extrude/revolve/cut), patterns, mates, materials, STEP export, and shield machine cutterhead design. Triggers: SolidWorks, SOLIDWORKS, SLDWORKS, ISldWorks, IModelDoc2,…

Source text: Chinese

2026-05-20

Showing 1 of 1 collected skill.