forgecad-component-model

Enforce ForgeCAD component models with origin-only parts and connector-based assemblies.

917|102|Updated Feb 8, 2026
One-click install
npx skills add https://github.com/KoStard/forgecad-public-kit --skill forgecad-component-model
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: forgecad-component-model
Source: https://github.com/KoStard/forgecad-public-kit/tree/main/skills/forgecad-component-model
Command: npx skills add https://github.com/KoStard/forgecad-public-kit --skill forgecad-component-model

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill prevents brittle ForgeCAD assemblies by enforcing a consistent component model so parts are pure functions and the assembly handles positioning and relationships via connectors and data flow.

Core Features & Use Cases

  • Origin-only parts: keeps each part’s geometry built at local origin without assembly-space offsets or structural coordinate math.
  • Connector-driven assembly: defines face-to-face connector interfaces so parts meet correctly without translate() hacks.
  • Prop/metadata flow discipline: routes dimensions downward as props and computed values upward as metadata so siblings never import each other.

Quick Start

Apply the component model by refactoring your multi-part ForgeCAD project so each part returns { shape, connectors, metadata } and the assembly composes parts using addPart() plus connect() couplings with zero coordinate math.

Frequently Asked Questions about forgecad-component-model

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fix coordinate bugs when assembling multi-part CAD models?

Multi-part CAD coordinate bugs are fixed by enforcing origin-only part geometry and using connector-based face-to-face composition. This standardizes how parts are positioned, eliminating manual translate hacks and inconsistent assembly-space offsets.

What is the best way to structure ForgeCAD components for large assemblies?

The best way to structure ForgeCAD components is making each part a pure function that returns shape, connectors, and metadata. The parent assembly then composes parts using addPart and connect couplings with zero coordinate math.

Why does my ForgeCAD assembly break when I update a single part?

Assemblies break from brittle structural coordinate math and sibling imports. Enforcing strict prop-down and metadata-up data flow isolates parts, ensuring computed values travel upward as metadata without direct sibling dependencies.

How do I validate component architecture without console logging in TypeScript?

You validate TypeScript component architecture by using verify.* methods instead of console logging. This enforces the ForgeCAD component model and confirms that parts meet correctly via connector interfaces without structural offsets.

Can I use translate() hacks to position parts in CAD assemblies?

You should not use translate hacks to position parts. The ForgeCAD component model requires origin-only part geometry and defines face-to-face connector interfaces so parts meet correctly without manual coordinate manipulation.

Do I need to refactor existing parts to use the ForgeCAD component model?

Yes, refactoring multi-part projects requires each part to return a shape, connectors, and metadata object. The assembly then composes these parts using addPart and connect couplings, enforcing strict prop-down and metadata-up data flow.