Forgecad

CAD parametrico in file .forge.js, con posizionamento basato su connettori e controlli CLI forgecad.

di KoStard · KoStard/forgecad-public-kit

Richiede configurazione ★ 9.6/10

Forgecad — CAD parametrico in file .forge.js, con posizionamento basato su connettori e controlli CLI forgecad.

Cosa fa

Guida l'autore, la modifica e il debug di modelli parametrici ForgeCAD scritti come file JavaScript .forge.js, indirizzando l'agente alla documentazione API inclusa per primitive, schizzi, assemblaggi, lamiera, SDF, esportazione e utilizzo della CLI. Si attiva quando si costruisce o si modifica la geometria ForgeCAD, si posizionano parti che devono accoppiarsi, si strutturano progetti ForgeCAD multi-file o si esegue forgecad run/render/inspect/export. Richiede la CLI ForgeCAD installata separatamente (npm install -g forgecad).

Rapporto di test

In una HOME temporanea ho eseguito `npm install -g forgecad` (0.13.0) e ho confermato che `forgecad run` funziona senza login, quindi ho costruito lo stesso fermacavo da scrivania in due parti due volte. La baseline (nessuna documentazione della skill) è andata in crash su `rotate(90,0,0)`, e dopo aver corretto dall'errore è stata eseguita ma ha renderizzato un anello completo che galleggiava dal bordo della piastra — bbox della scena 60x45x18 mm, min [-30,-30,-3], cioè 15 mm di sporgenza oltre una piastra profonda 30 mm. L'esecuzione della skill, dopo aver caricato la documentazione prescritta su core/coordinate/posizionamento, ha utilizzato `pointAlong` + `connector.male/female` + `matchTo` e `verify.connectorDistance`, dando bbox 60x30x15 mm, min [-30,-15,0], `✓ Verifications: 1 pass, 0 fail`, e un render che mostrava l'arco correttamente posizionato sulla parte superiore della piastra tra entrambi i fori dei bulloni. Tutti i 5 percorsi di documentazione controllati a campione hanno restituito HTTP 200; nessun curl|sh, blob base64 o testo di iniezione in nessun punto dell'albero della skill; l'unico vero attrito è la CLI npm globale obbligatoria e il placeholder {{SKILL_DIR}} non sostituito durante l'installazione tramite git clone.

Testato il: 2026-07-21 · Claude Code 2.x (agent harness)

Installazione

rm -rf /tmp/forgecad-src ~/.claude/skills/forgecad
git clone --depth 1 https://github.com/KoStard/forgecad-public-kit.git /tmp/forgecad-src
mkdir -p ~/.claude/skills
cp -R /tmp/forgecad-src/skills/forgecad ~/.claude/skills/forgecad
sed -i '' "s|{{SKILL_DIR}}|$HOME/.claude/skills/forgecad|g" ~/.claude/skills/forgecad/SKILL.md 2>/dev/null || sed -i "s|{{SKILL_DIR}}|$HOME/.claude/skills/forgecad|g" ~/.claude/skills/forgecad/SKILL.md
# The sed line is required: SKILL.md ships with a literal {{SKILL_DIR}} placeholder in every doc path.
# Required external tool (the skill is inert without it): npm install -g forgecad
# Verified working offline with no account: forgecad run <model.forge.js>, forgecad render 3d, forgecad inspect physical gaps.
# Hosted features (forgecad login, project clone/push, studio project sync) need a ForgeCAD account.
# Vendor alternative that also installs 10 companion workflow skills into ~/.agents/skills: forgecad skill install
# (use `forgecad skill install --core-only` for just this skill; it substitutes {{SKILL_DIR}} itself).

Comandi e prompt di esempio

/forgecadCAD parametrico in file .forge.js, con posizionamento basato su connettori e controlli CLI forgecad.

Gli skill si attivano con richieste in linguaggio naturale, senza comandi da ricordare. Dopo l'installazione, prompt come questi lo attivano (in inglese):

Create a ForgeCAD assembly from this SVG import
Debug why this .forge.js script fails to render
Structure this ForgeCAD project into multiple files

Rapporto completo →