К основному содержанию
скилл CX Codex

estimate-builder — скилл для Claude Code: что делает и как установить

Скилл estimate-builder формирует строительные сметы с разбивкой по статьям затрат и наценкам. Помогает рассчитать прямые расходы и итоговую сумму проекта.

MIT 172 установок ★ 434 обновлён 2026-10-19

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction --skill estimate-builder -a claude-code
Открыть на GitHub

Что делает estimate-builder

Скилл рассчитывает строительные сметы на основе Python-классов. Он распределяет затраты по категориям: работа, материалы, техника, подрядчики и прочие расходы. В каждой строке фиксируются WBS-код, объём и цена единицы.

Скилл поддерживает процентные наценки накладных расходов и прибыли. Базой для наценки выступают прямые затраты либо промежуточный итог. Сметные строки можно группировать по структуре WBS и экспортировать в DataFrame. Без установленных python3 и библиотеки pandas расчёт выполнить не удастся.

Какие задачи решает

  • разбить сметную стоимость по категориям затрат
  • рассчитать наценки на накладные расходы и плановую прибыль
  • сгруппировать позиции сметы по кодам структуры WBS
  • экспортировать строки сметы в таблицу pandas

Примеры запросов агенту

  • Посчитай стоимость работ по WBS 01.10 с наценкой на накладные расходы 15%
  • Добавь в смету укладку бетона объёмом 45 кубометров с ценой за единицу и категорией material
  • Сформируй итоговый отчёт по прямым затратам и марже проекта

Как установить estimate-builder

1Через Skills CLI (Vercel)

npx skills add datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction --skill estimate-builder -a claude-code

2Вручную: положить файлы

~/.claude/skills/estimate-builder/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/estimate-builder/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы об estimate-builder

Как установить estimate-builder в Claude Code?

Выполните команду npx skills add datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction --skill estimate-builder -a claude-code.

Что делает скилл estimate-builder?

Он формирует строительные сметы с разделением расходов на материалы, труд, технику и субподрядчиков, а также рассчитывает накладные расходы и итоговую стоимость.

Какие зависимости нужны для работы estimate-builder?

Для работы требуются интерпретатор python3 и установленный пакет pandas.

Исходный текст

SKILL.md · MIT
---
name: "estimate-builder"
description: "Build construction project estimates. Generate detailed cost breakdowns with labor, materials, equipment, and overhead."
homepage: "https://datadrivenconstruction.io"
metadata: {"openclaw":{"emoji":"📊","os":["darwin","linux","win32"],"homepage":"https://datadrivenconstruction.io","requires":{"bins":["python3"]}}}
---

# Estimate Builder

## Business Case

### Problem Statement
Estimate creation challenges:
- Complex cost structures
- Multiple cost categories
- Markup calculations
- Format requirements vary

### Solution
Structured estimate builder that creates professional construction estimates with proper cost categorization, markups, and export capabilities.

## Technical Implementation

```python
import pandas as pd
from typing import Dict, Any, List, Optional
from dataclasses import dataclass, field
from datetime import date
from enum import Enum


class CostCategory(Enum):
    LABOR = "labor"
    MATERIAL = "material"
    EQUIPMENT = "equipment"
    SUBCONTRACTOR = "subcontractor"
    OTHER = "other"


@dataclass
class EstimateLineItem:
    line_number: int
    wbs_code: str
    description: str
    quantity: float
    unit: str
    unit_cost: float
    category: CostCategory
    notes: str = ""

    @property
    def total_cost(self) -> float:
        return round(self.quantity * self.unit_cost, 2)


@dataclass
class CostSummary:
    labor: float = 0
    material: float = 0
    equipment: float = 0
    subcontractor: float = 0
    other: float = 0

    @property
    def direct_cost(self) -> float:
        return self.labor + self.material + self.equipment + self.subcontractor + self.other


@dataclass
class Markup:
    name: str
    rate: float  # As decimal (0.10 = 10%)
    base: str = "direct"  # "direct" or "subtotal"


class EstimateBuilder:
    """Build construction project estimates."""

    def __init__(self, project_name: str, project_number: str = ""):
        self.project_name = project_name
        self.project_number = project_number
        self.estimate_date = date.today()
        self.items: List[EstimateLineItem] = []
        self.markups: List[Markup] = []
        self._next_line = 1

    def add_item(self,
                 wbs_code: str,
                 description: str,
                 quantity: float,
                 unit: str,
                 unit_cost: float,
                 category: CostCategory = CostCategory.OTHER,
                 notes: str = "") -> EstimateLineItem:
        """Add line item to estimate."""

        item = EstimateLineItem(
            line_number=self._next_line,
            wbs_code=wbs_code,
            description=description,
            quantity=quantity,
            unit=unit,
            unit_cost=unit_cost,
            category=category,
            notes=notes
        )
        self.items.append(item)
        self._next_line += 1
        return item

    def add_markup(self, name: str, rate: float, base: str = "direct"):
        """Add markup (overhead, profit, contingency, etc.)."""
        self.markups.append(Markup(name=name, rate=rate, base=base))

    def set_standard_markups(self,
                             overhead: float = 0.15,
                             profit: float = 0.10,
                             contingency: float = 0.05):
        """Set standard construction markups."""

        self.markups = [
            Markup("General Conditions / Overhead", overhead, "direct"),
            Markup("Profit", profit, "subtotal"),
            Markup("Contingency", contingency, "subtotal")
        ]

    def get_cost_summary(self) -> CostSummary:
        """Get cost summary by category."""

        summary = CostSummary()
        for item in self.items:
            cost = item.total_cost
            if item.category == CostCategory.LABOR:
                summary.labor += cost
            elif item.category == CostCategory.MATERIAL:
                summary.material += cost
            elif item.category == CostCategory.EQUIPMENT:
                summary.equipment += cost
            elif item.category == CostCategory.SUBCONTRACTOR:
                summary.subcontractor += cost
            else:
                summary.other += cost
        return summary

    def calculate_total(self) -> Dict[str, Any]:
        """Calculate total estimate with markups."""

        summary = self.get_cost_summary()
        direct_cost = summary.direct_cost

        markups_detail = []
        subtotal = direct_cost

        for markup in self.markups:
            if markup.base == "direct":
                amount = direct_cost * markup.rate
            else:
                amount = subtotal * markup.rate

            markups_detail.append({
                'name': markup.name,
                'rate': f"{markup.rate * 100:.1f}%",
                'amount': round(amount, 2)
            })
            subtotal += amount

        return {
            'cost_summary': {
                'labor': round(summary.labor, 2),
                'material': round(summary.material, 2),
                'equipment': round(summary.equipment, 2),
                'subcontractor': round(summary.subcontractor, 2),
                'other': round(summary.other, 2),
                'direct_cost': round(direct_cost, 2)
            },
            'markups': markups_detail,
            'total_markups': round(subtotal - direct_cost, 2),
            'grand_total': round(subtotal, 2)
        }

    def get_items_by_wbs(self) -> Dict[str, List[EstimateLineItem]]:
        """Group items by WBS code prefix."""

        by_wbs = {}
        for item in self.items:
            prefix = item.wbs_code.split('.')[0] if '.' in item.wbs_code else item.wbs_code
            if prefix not in by_wbs:
                by_wbs[prefix] = []
            by_wbs[prefix].append(item)
        return by_wbs

    def import_from_df(self, df: pd.DataFrame):
        """Import line items from DataFrame."""

        for _, row in df.iterrows():
            self.add_item(
                wbs_code=str(row.get('wbs_code', '')),
                description=row['description'],
                quantity=float(row['quantity']),
                unit=row['unit'],
                unit_cost=float(row['unit_cost']),
                category=CostCategory(row.get('category', 'other').lower()),
                notes=row.get('notes', '')
            )

    def export_to_df(self) -> pd.DataFrame:
        """Export estimate to DataFrame."""

        data = []
        for item in self.items:
            data.append({
                'Line': item.line_number,
                'WBS': item.wbs_code,
                'Description': item.description,
                'Qty': item.quantity,
                'Unit': item.unit,
                'Unit Cost': item.unit_cost,
                'Total': item.total_cost,
                'Category': item.category.value,
                'Notes': item.notes
            })
        return pd.DataFrame(data)

    def export_to_excel(self, output_path: str) -> str:
        """Export estimate to Excel."""

        totals = self.calculate_total()

        with pd.ExcelWriter(output_path, engine='openpyxl') as writer:
            # Cover sheet
            cover_df = pd.DataFrame([{
                'Project Name': self.project_name,
                'Project Number': self.project_number,
                'Estimate Date': self.estimate_date,
                'Total Items': len(self.items),
                'Direct Cost': totals['cost_summary']['direct_cost'],
                'Grand Total': totals['grand_total']
            }])
            cover_df.to_excel(writer, sheet_name='Summary', index=False)

            # Line items
            items_df = self.export_to_df()
            items_df.to_excel(writer, sheet_name='Line Items', index=False)

            # Cost breakdown
            breakdown_df = pd.DataFrame([totals['cost_summary']])
            breakdown_df.to_excel(writer, sheet_name='Cost Breakdown', index=False)

            # Markups
            if totals['markups']:
                markups_df = pd.DataFrame(totals['markups'])
                markups_df.to_excel(writer, sheet_name='Markups', index=False)

        return output_path

    def validate(self) -> List[str]:
        """Validate estimate for common issues."""

        issues = []

        if not self.items:
            issues.append("Estimate has no line items")

        for item in self.items:
            if item.quantity <= 0:
                issues.append(f"Line {item.line_number}: Invalid quantity")
            if item.unit_cost < 0:
                issues.append(f"Line {item.line_number}: Negative unit cost")
            if not item.description:
                issues.append(f"Line {item.line_number}: Missing description")

        if not self.markups:
            issues.append("No markups defined (overhead, profit)")

        return issues
```

## Quick Start

```python
# Create estimate
estimate = EstimateBuilder("Office Building A", "PRJ-2024-001")

# Add line items
estimate.add_item("01.01", "Site Preparation", 5000, "SF", 2.50, CostCategory.OTHER)
estimate.add_item("03.01", "Concrete Foundation", 200, "CY", 350, CostCategory.MATERIAL)
estimate.add_item("03.02", "Foundation Formwork", 1500, "SF", 8.50, CostCategory.LABOR)
estimate.add_item("05.01", "Structural Steel", 50, "TON", 4500, CostCategory.SUBCONTRACTOR)

# Set markups
estimate.set_standard_markups(overhead=0.15, profit=0.10, contingency=0.05)

# Calculate total
result = estimate.calculate_total()
print(f"Direct Cost: ${result['cost_summary']['direct_cost']:,.2f}")
print(f"Grand Total: ${result['grand_total']:,.2f}")
```

## Common Use Cases

### 1. Cost by Category
```python
summary = estimate.get_cost_summary()
print(f"Labor: ${summary.labor:,.2f}")
print(f"Material: ${summary.material:,.2f}")
```

### 2. Export to Excel
```python
estimate.export_to_excel("estimate_output.xlsx")
```

### 3. Validate Estimate
```python
issues = estimate.validate()
for issue in issues:
    print(f"Warning: {issue}")
```

## Resources
- **DDC Book**: Chapter 3.1 - Cost Calculations and Estimates
- **Website**: https://datadrivenconstruction.io

© datadrivenconstruction · MIT · datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction

Похожие скиллы

Все скиллы по теме «Финансы и бизнес» →
HORIZON SHIELD KIRA ogasurfproject-jpg MCP-сервер HORIZON SHIELD KIRA для Claude Code сверяет строительные и ремонтные сметы с ценовыми диапазонами для Японии. Он также проверяет подозрительные формулировки и фиксирует проверки в квитанции с отметкой Bitcoin. CX Codex +1 1 450установок GetFacade getfacade MCP-сервер GetFacade генерирует варианты отделки фасада по фотографии дома, рассчитывает смету и готовит PDF-альбом чертежей. CX Codex +1 ★ 1звёзд репо estimate-analysis himself65 Скилл estimate-analysis для Claude Code собирает консенсус-оценки аналитиков по тикеру из Yahoo Finance и отслеживает динамику ревизий за 7, 30, 60 и 90 дней. CX Codex +1 3 600установок agent-estimate kiloloop Плагин agent-estimate для Claude Code оценивает сроки задач для ИИ-агентов методом PERT. Он сравнивает прогноз с человеческим темпом и проверяет надёжность выбранной модели. ★ 7звёзд репо horizon-shield oga-surf-project MCP-сервер horizon-shield сверяет смету на японский ремонт или стройку с рыночными диапазонами, отмечает переплату и приёмы давления, отдаёт проверяемое подтверждение цены. CX Codex +1 1 058установок stock-liquidity himself65 Скилл stock-liquidity оценивает ликвидность акций через библиотеку yfinance: спреды bid-ask, объёмы торгов и рыночный импакт. Помогает рассчитать издержки перед входом в позицию. CX Codex +1 3 600установок

Из того же набора156

Весь набор →
ifc-data-extraction Скилл ifc-data-extraction извлекает структурированные данные из IFC-файлов через IfcOpenShell: элементы, количества, свойства, пространственные связи. Нужен Python 3 и IfcOpenShell в PATH. CX Codex +1 195установок bim-clash-detection Скилл bim-clash-detection для Claude Code автоматически выявляет геометрические конфликты между элементами BIM-модели. Помогает обнаружить проблемы координации на этапе проектирования. CX Codex +1 184установок ifc-qto-extraction Скилл ifc-qto-extraction для Claude Code извлекает количества элементов, площади, объёмы и длины из IFC- и Revit-моделей для смет; группирует данные по типам, уровням и зонам, экспортирует в Excel. CX Codex +1 178установок bim-consistency-checker Скилл bim-consistency-checker для Claude Code проверяет согласованность BIM-модели: имена, параметры, связи и данные элементов. Находит ошибки перед передачей модели. CX Codex +1 177установок ifc-to-excel Скилл ifc-to-excel для Claude Code преобразует IFC-модели в таблицы Excel и файлы 3D-геометрии. Извлекает свойства и пакетно обрабатывает модели. CX Codex +1 163установок gantt-chart Скилл gantt-chart рисует диаграммы Ганта для строительных проектов: задачи с зависимостями, прогресс, критический путь. Экспортирует в текст, Mermaid и HTML. CX Codex +1 160установок pandas-construction-analysis Скилл pandas-construction-analysis для работы с данными строительных проектов через Pandas. Фильтрует элементы BIM, считает объёмы, объединяет датасеты и выводит отчёты — всё на Python. Нужен Python 3 в системе. CX Codex +1 153установок xlsx-construction Скилл xlsx-construction для работы с Excel-файлами в строительных проектах: сметы, графики, логи РФИ, ведомости объёмов. Помогает агенту создавать и редактировать таблицы с формулами и форматированием. CX Codex +1 150установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой