Speckle Impl Tekla

speckle-impl-tekla

Quick Reference

Connector Capabilities

| Capability | Status | Notes | |------------|--------|-------| | Publish (Send) | Yes | All selectable model objects | | Receive (Load) | NO | Not implemented -- publish-only connector | | Supported Versions | 2023, 2024, 2025 | Windows only | | Schema Type | TeklaObject | Extends DataObject | | Geometry Format | Brep | Stored in displayValue | | Proxy Types | RenderMaterial | Only proxy type used |

Data Schema Hierarchy

Root Collection
  └── Tekla File
        └── Type (Beam, Column, Plate, etc.)
              └── TeklaObject

Critical Warnings

NEVER attempt to receive/load data INTO Tekla Structures -- the Tekla connector is PUBLISH-ONLY. There is NO receive functionality. If a workflow requires loading data into Tekla, use an intermediate format (IFC) or request the feature via the Speckle Community Forum.

NEVER expect assemblies in the published output -- Tekla assemblies are NOT published to Speckle. Only individual parts (beams, plates, bolts, etc.) are converted.

NEVER publish from a Tekla drawing view -- the connector ONLY works from the model viewport. Attempting to publish from drawing views ALWAYS fails. ALWAYS switch to the model viewport before publishing.

NEVER expect drawing layouts, title blocks, or annotation data in the Speckle output -- drawings are NOT part of the published data.

NEVER expect numbering series or sequence settings to appear in the published model -- these Tekla-specific organizational constructs are NOT converted.

NEVER expect nested TeklaObjects -- TeklaObjects do NOT contain child TeklaObjects. Each structural element is a flat, independent object in the hierarchy.

---

Publish-Only Architecture

The Tekla connector is fundamentally different from bidirectional connectors (Revit, Rhino, Blender). It supports ONE direction only:

Tekla Structures  ----[publish]---->  Speckle Server
                   Speckle Server --> Federated View (Viewer/Power BI)
Tekla Model --------/                   \--> NEVER back to Tekla

Common Federation Patterns

| Pattern | Tekla Role | Other Tools | |---------|-----------|-------------| | Structural coordination | Publisher of steel/concrete model | Revit (architectural), Rhino (facade) | | Clash detection | Publisher of structural elements | All other disciplines in viewer | | Progress tracking | Publisher of as-built model | Speckle Automate for analysis | | Design review | Publisher of structural model | Viewer for stakeholder review |

---

Proxy Architecture

The Tekla connector uses ONLY one proxy type:

RenderMaterial Proxy

• Material appearance data stored at Root Collection level
• Referenced by TeklaObjects via applicationId
• Contains color, opacity properties
• Does NOT contain textures (Speckle NEVER transfers textures)

---

Platform Constraints

| Constraint | Detail | |------------|--------| | Operating system | Windows only | | Tekla versions | 2023, 2024, 2025 | | Viewport requirement | Model viewport only (not drawing views) | | Data direction | Publish only | | Geometry type | Brep (boundary representation) | | Units | Follows Tekla model units (typically mm) |

---

Reference Links

• [references/methods.md](references/methods.md) -- TeklaObject properties, publish API, selection methods
• [references/examples.md](references/examples.md) -- Working publish workflows, federation patterns, downstream data access
• [references/anti-patterns.md](references/anti-patterns.md) -- What NOT to do with the Tekla connector

Official Sources

• Tekla Connector (User Docs): https://docs.speckle.systems/connectors/tekla.md
• Tekla Schema: https://docs.speckle.systems/developers/data-schema/connectors/tekla-schema.md
• Speckle Community Forum: https://speckle.community/

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: Impertio-Studio
• Source: Impertio-Studio/Speckle-Claude-Skill-Package
• License: MIT

Install and usage instructions live in the source repository linked above.