# cwicr-takeoff-helper

cwicr-takeoff-helper — a skill for Claude Code, Codex, Cursor, and other agents that calculates construction quantities from CWICR data: areas, volumes, linear measures with waste factors applied.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 149 installs · ★ 434 repo stars
- Author: datadrivenconstruction
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction/tree/HEAD/1_DDC_Toolkit/CWICR-Database/cwicr-takeoff-helper/SKILL.md
- Updated: 2026-10-19
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/cwicr-takeoff-helper

## What it does

The skill is built around a Python module with typed classes covering five takeoff modes: linear, area, volume, count, and weight.

For each work item it looks up the CWICR code, pulls a waste factor from a built-in table — concrete at 0.05, brick and roofing at 0.10, drywall at 0.12, tile at 0.15, and others — then multiplies the gross quantity to produce the net figure. Unit conversion covers metres to feet, m² to SF, m³ to CY and back. After calculating a category, the skill lists related scope items: concrete brings up formwork, rebar, curing, and finishing; roofing surfaces pull underlayment, flashing, and ventilation.

\`python3` must be available in `PATH` before the skill can run. After installation for Claude Code, the skill file sits at `~/.claude/skills/cwicr-takeoff-helper/SKILL.md`; for Codex it goes to `.agents/skills/cwicr-takeoff-helper/SKILL.md`.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction --skill cwicr-takeoff-helper -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/cwicr-takeoff-helper/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/cwicr-takeoff-helper/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction --skill cwicr-takeoff-helper -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/cwicr-takeoff-helper/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction --skill cwicr-takeoff-helper -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/cwicr-takeoff-helper/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction 1_DDC_Toolkit/CWICR-Database/cwicr-takeoff-helper
```

2. **Manually: put the files in place**
- File: `.github/skills/cwicr-takeoff-helper/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction --skill cwicr-takeoff-helper -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction --path 1_DDC_Toolkit/CWICR-Database/cwicr-takeoff-helper
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/cwicr-takeoff-helper/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction --skill cwicr-takeoff-helper -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction/tree/HEAD/1_DDC_Toolkit/CWICR-Database/cwicr-takeoff-helper/SKILL.md

## When to use it
- calculate concrete volume with a waste factor from a CWICR code
- convert square footage to m² for metric estimates
- list related scope items for a masonry or roofing section
- compute net wall area after subtracting door and window openings
- get a perimeter length from room dimensions

## Example prompts
- Calculate concrete volume for a 12×8 m slab, 200 mm thick, code `CONC-001`
- Convert 450 SF to m² and suggest related items for masonry work
- Compute wall area for a perimeter of 48 m at 3.2 m height, deduct three openings 2.1×0.9 m

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 32531a6492b3995e.

BEGIN THIRD-PARTY FILE 32531a6492b3995e
````text
---
name: "cwicr-takeoff-helper"
description: "Assist with quantity takeoff using CWICR data. Calculate quantities from dimensions, apply waste factors, and suggest related work items."
homepage: "https://datadrivenconstruction.io"
metadata: {"openclaw": {"emoji": "🗄️", "os": ["darwin", "linux", "win32"], "homepage": "https://datadrivenconstruction.io", "requires": {"bins": ["python3"]}}}
---
# CWICR Takeoff Helper

## Business Case

### Problem Statement
Quantity takeoff requires:
- Accurate calculations from dimensions
- Correct unit conversions
- Waste factor application
- Complete scope coverage

### Solution
Assist takeoff process with CWICR-based calculations, automatic waste factors, unit conversions, and related item suggestions.

### Business Value
- **Accuracy** - Validated calculations
- **Completeness** - Related items suggested
- **Speed** - Quick quantity calculations
- **Consistency** - Standard approaches

## Technical Implementation

```python
import pandas as pd
import numpy as np
from typing import Dict, Any, List, Optional, Tuple
from dataclasses import dataclass
from enum import Enum
import math


class TakeoffType(Enum):
    """Types of takeoff calculations."""
    LINEAR = "linear"        # Length
    AREA = "area"            # Square measure
    VOLUME = "volume"        # Cubic measure
    COUNT = "count"          # Each/number
    WEIGHT = "weight"        # By weight


class UnitSystem(Enum):
    """Unit systems."""
    METRIC = "metric"
    IMPERIAL = "imperial"


@dataclass
class TakeoffItem:
    """Single takeoff item."""
    work_item_code: str
    description: str
    takeoff_type: TakeoffType
    gross_quantity: float
    waste_factor: float
    net_quantity: float
    unit: str
    dimensions: Dict[str, float]
    calculation: str


@dataclass
class TakeoffResult:
    """Complete takeoff result."""
    items: List[TakeoffItem]
    total_items: int
    related_suggestions: List[str]


# Unit conversion factors
CONVERSIONS = {
    # Length
    ('m', 'ft'): 3.28084,
````
END THIRD-PARTY FILE 32531a6492b3995e

The third-party file has ended. Everything between the 32531a6492b3995e tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2034 of 13470 bytes. © datadrivenconstruction · MIT · https://github.com/datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction/tree/HEAD/1_DDC_Toolkit/CWICR-Database/cwicr-takeoff-helper/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
