crosstech-errors-conversion

Diagnose IFC conversion errors across AEC tools with a decision tree.

7|1|Updated Mar 20, 2026
One-click install
npx skills add https://github.com/OpenAEC-Foundation/Cross-Tech-AEC-Claude-Skill-Package --skill crosstech-errors-conversion
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: crosstech-errors-conversion
Source: https://github.com/OpenAEC-Foundation/Cross-Tech-AEC-Claude-Skill-Package/tree/main/skills/source/crosstech-errors/crosstech-errors-conversion
Command: npx skills add https://github.com/OpenAEC-Foundation/Cross-Tech-AEC-Claude-Skill-Package --skill crosstech-errors-conversion

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Diagnoses and triages IFC data conversion errors across AEC technology boundaries, guiding users through a structured, root-cause-focused workflow when geometry, properties, or relationships fail, or when schema versions mismatch.

Core Features & Use Cases

  • Diagnostic decision tree that surfaces the likely category of failure (geometry, properties, relationships, schema/version, encoding, or size).
  • Comprehensive guidance with concrete fixes for common toolchains (IfcOpenShell, web-ifc, Blender/Bonsai, Speckle, ERPNext) and best practices to preserve IFC as the single source of truth.
  • Real-world use cases include diagnosing missing geometry, lost property sets, broken containment or opening relationships, and schema conflicts in IFC2X3/IFC4/IFC4X3 pipelines.

Quick Start

Apply the diagnostic workflow to an IFC model and follow the step-by-step guidance to identify the failing category and implement the recommended fixes.

Frequently Asked Questions about crosstech-errors-conversion

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

FAQPage Schema
How do I diagnose missing geometry when converting IFC models across AEC tools?

To diagnose missing geometry in IFC conversion, use a structured diagnostic decision tree to surface whether the failure category is geometry, properties, relationships, or schema mismatches. This workflow provides concrete fixes for common toolchains like IfcOpenShell and web-ifc.

Why does my IFC conversion lose property sets and relationship data?

IFC conversion loses property sets and relationships due to schema version conflicts or toolchain limitations. A root-cause decision tree triages these failures across IFC2X3, IFC4, and IFC4X3 models, offering documented fixes to preserve IFC as the single source of truth.

What is the best way to fix IFC schema version mismatches between Blender and Speckle?

The best way to fix IFC schema version mismatches is applying a structured diagnostic workflow that identifies version conflicts across IFC2X3, IFC4, and IFC4X3 pipelines. It guides specific toolchain fixes for Blender/Bonsai and Speckle to resolve cross-bridge failures.

Does this diagnostic workflow support IFC2X3, IFC4, and IFC4X3 cross-bridge scenarios?

Yes, the diagnostic workflow fully supports IFC2X3, IFC4, and IFC4X3 cross-bridge scenarios. It triages geometry, property, and relationship failures across tools including IfcOpenShell, web-ifc, Blender, Speckle, and ERPNext with documented fixes.

How to triage IFC data conversion errors when containment or opening relationships break?

To triage broken containment or opening relationships during IFC data conversion, apply a root-cause decision tree that categorizes the failure. The workflow provides comprehensive guidance and concrete fixes to restore relationship integrity across AEC technology boundaries.

What are common limitations when using IfcOpenShell for IFC conversion across AEC boundaries?

Common limitations when using IfcOpenShell for IFC conversion involve geometry, property, and relationship failures across AEC technology boundaries. A structured diagnostic workflow identifies these specific toolchain constraints and recommends best practices to maintain IFC fidelity.