Guide to OpenConstructionERP: architecture, modules, API surface and quick start.

MITAuto-check passedBackend & APIs

Install Oce Platform Overview

skills CLI
$ npx skills add datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction --skill oce-platform-overview -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction oce-platform-overview --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction.git skills-src && mkdir -p .claude/skills && cp -r skills-src/6_OpenConstructionERP/oce-platform-overview .claude/skills/oce-platform-overview && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
oce-platform-overview
GitHub stars
344
Token cost
~774 tokens
SKILL.md length
275 words
Files
1
Skills in repo
43
Repo updated
First seen
Licence
MIT

At a glance

Guide to OpenConstructionERP: architecture, modules, API surface and quick start.

  • Works in 3 steps: Load the base first (load-cwicr), then… → Never invent prices: leave unpriced… → Verify an import with GET…
  • Starting any OpenConstructionERP work
  • SKILL.md covers What it is, Module map (what to use when), Quick start (dev) and Data contracts to respect, plus 1 more section
  • Calls python and npm

What it does

Oce Platform Overview is an agent skill from datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction. Guide to OpenConstructionERP: architecture, modules, API surface and quick start. Use when starting any OpenConstructionERP work, onboarding a user to the platform, or deciding which module/endpoint to use.

Its SKILL.md is about 770 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Backend & APIs. The repository describes itself as: 221 AI skills for construction: BIM analysis, cost estimation, scheduling, document control, and automation with Claude Code. The licence is MIT.

When your agent uses it

  • Starting any OpenConstructionERP work
  • Onboarding a user to the platform
  • Deciding which module/endpoint to use

Example prompts

  • “/oce-platform-overview”

Requirements

  • Python 3
  • Docker

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Load the base first (load-cwicr), then swap language (automatic via home_language_code), then reprice markets via the catalog path.
  2. Never invent prices: leave unpriced coefficient bases (VN, ID) as rate 0 and use the resource price sheet.
  3. Verify an import with GET /api/v1/costs/regions/stats/ and a sampled item's rate against the parquet's total_cost_per_position.

What it can do on your machine

Read from SKILL.md and the folder at commit ce45bbf. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • python
    • npm

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • openconstructionerp.com
    • github.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Oce Platform Overview loads about 774 tokens when it runs. Until then it costs about 57 tokens; SKILL.md has 275 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~57
When it runs · the whole SKILL.md, loaded when a task matches
~774

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction at commit ce45bbf, republished under its MIT licence (© datadrivenconstruction). 275 words, ~774 tokens.

Download SKILL.mdSave it as .claude/skills/oce-platform-overview/SKILL.md (or your agent's skills folder).
name
oce-platform-overview
description
Guide to OpenConstructionERP: architecture, modules, API surface and quick start. Use when starting any OpenConstructionERP work, onboarding a user to the platform, or deciding which module/endpoint to use.

OpenConstructionERP Platform Overview

What it is

OpenConstructionERP is a self-hosted, open-source (AGPL-3.0) construction ERP by DataDrivenConstruction: BOQ management, CAD/BIM takeoff (RVT/IFC/DWG/DGN), 4D scheduling, 5D cost modelling, tendering, field management and 180+ modules in one platform. It runs embedded PostgreSQL (no Docker required) with a FastAPI backend and a Vite/React frontend.

Homepage: https://openconstructionerp.com · Repo: https://github.com/datadrivenconstruction/OpenConstructionERP · Docs: https://openconstructionerp.com/docs

Module map (what to use when)

NeedModuleKey endpoints
Browse/load cost databasescostsGET /api/v1/costs/base-catalog, POST /api/v1/costs/load-cwicr/{db_id}, GET /api/v1/costs/?region=...&q=...
Resource catalogscatalogPOST /api/v1/catalog/import/{region}, GET /api/v1/catalog/...
Bill of quantitiesboqPOST /api/v1/boqs, GET /api/v1/boqs/{id}, validate/import GAEB
BIM elements / takeoffbimupload RVT/IFC/DWG/DGN, link elements to BOQ lines
Schedule (4D) / cost (5D)schedulingtasks, dependencies, cost model roll-ups
Issues & qualitypunch_list, validationpunch items, validation rule packs (DIN276/NRM/GAEB)
Site daily opsdaily_diary, hsediary entries, safety observations
Docs / tasks / risksdocuments, tasks, risksfile approvals, task board, risk register
Portfolio mapgeo_hubprojects on a 3D globe
Property developmentproperty_devlead → SPA → handover

Quick start (dev)

bash
cd backend && python -m uvicorn app.main:create_app --factory --reload --port 8000
cd frontend && npm run dev   # http://localhost:5173

Auth: bootstrap admin (first registered user), JWT tokens, role-based permissions (viewer/editor/manager/admin). POST /auth/register, POST /auth/login.

Data contracts to respect

  • CWICR work-item parquets follow the 95-column master schema (rate_code, rate_original_name, rate_final_name, rate_unit, total_cost_per_position, classification collection/department/section/subsection/category, resource lines resource_*, flags is_material/is_machine/is_labor).
  • Region ids match ^[A-Z]{2,3}_[A-Z0-9]+$ (e.g. TR_NATIONAL, ZH_CHINA, BR_NATIONAL).
  • The importer is idempotent on (code, region) — re-loading returns already_loaded.

Best practices

  1. Load the base first (load-cwicr), then swap language (automatic via home_language_code), then reprice markets via the catalog path.
  2. Never invent prices: leave unpriced coefficient bases (VN, ID) as rate 0 and use the resource price sheet.
  3. Verify an import with GET /api/v1/costs/regions/stats/ and a sampled item's rate against the parquet's total_cost_per_position.

© datadrivenconstruction, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in 6_OpenConstructionERP/oce-platform-overview of datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction.

Open the folder on GitHubat commit ce45bbf

Compare with similar skills

Oce Platform Overview next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Oce Platform Overview compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Oce Platform Overview this skilldatadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction344—~774Automated safety check: PassMIT
Configuring Horizoncoollabsio/coolify63k4 repos~898Automated safety check: PassMIT
Nestjs Best Practicesrolling-scopes/rsschool-app10k6 repos~1.2kAutomated safety check: PassMIT
Sub2API AdminWei-Shaw/sub2api43k1 repos~717Automated safety check: PassLGPL-3.0
Firecrawl Build Onboardingfirecrawl/firecrawl190k1 repos~1.4kAutomated safety check: NotesISC
Obsidian BasesAtmosphere/atmosphere3.8k22 repos~3.2kAutomated safety check: PassApache-2.0

Similar skills

  • Configuring Horizon

    coollabsio/coolify

    A skill your agent uses whenever the user mentions Horizon by name in a Laravel context.

    63k GitHub starsUsed in 4 repos~898 tokens
    Backend & APIsAuto-check passed
  • Nestjs Best Practices

    rolling-scopes/rsschool-app

    NestJS best practices and architecture patterns for building production-ready applications.

    10k GitHub starsUsed in 6 repos~1.2k tokens
    Backend & APIsAuto-check passed
  • Sub2API Admin

    Wei-Shaw/sub2api

    Manages a Sub2API deployment from the command line: accounts, redeem and invitation codes, groups, proxies, imports, exports and raw admin API calls.

    43k GitHub starsUsed in 1 repo~717 tokens
    Backend & APIsAuto-check passed
  • Firecrawl Build Onboarding

    firecrawl/firecrawl

    Gets Firecrawl working in a project: signs you in through the browser, saves FIRECRAWL_API_KEY to .env and picks the first SDK or REST path.

    190k GitHub starsUsed in 1 repo~1.4k tokens
    Backend & APIsAuto-check: notes
  • Obsidian Bases

    Atmosphere/atmosphere

    Create and edit Obsidian Bases (.base files) with views, filters, formulas, and summaries.

    3.8k GitHub starsUsed in 22 repos~3.2k tokens
    Backend & APIsAuto-check passed
  • Fortify Development

    coollabsio/coolify

    ACTIVATE when the user works on authentication in Laravel. An agent skill from coollabsio/coolify.

    63k GitHub starsUsed in 4 repos~1.9k tokens
    Backend & APIsAuto-check passed

More from datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction

All 43 skills in this repo
  • AI Agent Orchestration

    datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction

    Orchestrate multiple AI agents for construction workflows: estimator, scheduler, document, QA and safety agents coordinated by a supervisor agent, with human checkpoints.

    344 GitHub stars~679 tokensUpdated 1 mo ago
    Auto-check passed
  • Embodied Carbon Esg

    datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction

    Estimate embodied carbon and produce ESG/climate reporting for construction: LCA per work item, material-based carbon factors, EU taxonomy and CSRD alignment.

    344 GitHub stars~664 tokensUpdated 1 mo ago
    Auto-check passed
  • Material Passports Circular

    datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction

    Material passports and circular construction: generate per-element material inventories from BOQ/BIM, mark reuse potential and recycled content, and prepare deconstruction data.

    344 GitHub stars~634 tokensUpdated 1 mo ago
    Auto-check passed
  • Oce Cost Browser

    datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction

    Browse and search the OpenConstructionERP cost database: classification tree, SQL and semantic search, autocomplete, certainty badges, and the resource catalog.

    344 GitHub stars~637 tokensUpdated 1 mo ago
    Auto-check passed
  • Oce Estimate Boq

    datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction

    Create bills of quantities and estimates in OpenConstructionERP: search cost items, build BOQ sections, link BIM elements in bulk, validate the BOQ, and export GAEB/XLSX/JSON.

    344 GitHub stars~763 tokensUpdated 1 mo ago
    Auto-check passed
  • Oce Field Ops

    datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction

    Field operations in OpenConstructionERP: punch list, daily diary, HSE observations and task tracking on site.

    344 GitHub stars~532 tokensUpdated 1 mo ago
    Auto-check passed

Categories

Questions about Oce Platform Overview

What does Oce Platform Overview do?

Guide to OpenConstructionERP: architecture, modules, API surface and quick start. Oce Platform Overview is an agent skill from datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction. Guide to OpenConstructionERP: architecture, modules, API surface and quick start.

When should I use Oce Platform Overview?

Oce Platform Overview fits situations like: starting any OpenConstructionERP work; onboarding a user to the platform; deciding which module/endpoint to use.

How do I install Oce Platform Overview in Claude Code?

Run `npx skills add datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction --skill oce-platform-overview -a claude-code`. Or copy the skill folder (6_OpenConstructionERP/oce-platform-overview in datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction) into .claude/skills/oce-platform-overview in your project. Claude Code loads it when a task matches its description.

How do I install Oce Platform Overview in Codex?

Run `npx skills add datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction --skill oce-platform-overview -a codex`. Or copy the skill folder (6_OpenConstructionERP/oce-platform-overview in datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction) into .agents/skills/oce-platform-overview in your project. Codex loads it when a task matches its description.

Can I use Oce Platform Overview in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction --skill oce-platform-overview -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/oce-platform-overview, .gemini/skills/oce-platform-overview, .github/skills/oce-platform-overview and .opencode/skills/oce-platform-overview in your project.

What does Oce Platform Overview need to run?

Going by SKILL.md and its folder, Oce Platform Overview needs the command-line tools its instructions call (python and npm). Our summary lists: Python 3; Docker.

Does Oce Platform Overview access the network?

SKILL.md names 2 domains. As links in the text: openconstructionerp.com and github.com. This is read from the text; nothing was executed.

Is Oce Platform Overview safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Oce Platform Overview use?

Oce Platform Overview is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Oce Platform Overview use?

About 774 tokens (SKILL.md is roughly 3.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Oce Platform Overview?

Skills that share tags, products or a category with Oce Platform Overview: Configuring Horizon (coollabsio/coolify, 63k stars), Nestjs Best Practices (rolling-scopes/rsschool-app, 10k stars), Sub2API Admin (Wei-Shaw/sub2api, 43k stars) and Firecrawl Build Onboarding (firecrawl/firecrawl, 190k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Oce Platform Overview?

datadrivenconstruction (a GitHub user) maintains it in datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction, which has 344 GitHub stars. The repository holds 43 skills in this directory. The repository was last updated on August 22, 2026.

Source: datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.