# material-procurement-tracker

material-procurement-tracker is a skill that tracks construction materials from requisition through delivery, flags late orders, and summarizes procurement status and purchase-order value.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 124 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/Procurement/material-procurement-tracker/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/material-procurement-tracker

## What it does

This skill describes a Python tracker for project materials. Each item can record its specification section, quantity, required date, lead time, and priority. You can also attach vendor and purchase-order details, plus an expected delivery date.

The tracker lists items whose order-by date falls within the next 14 days and flags items already late to order. Its summary counts items by status and adds up purchase-order values. The log exports to Excel through `pandas`; that library is needed for the export. The runtime requires `python3`.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction --skill material-procurement-tracker -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction --skill material-procurement-tracker -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/material-procurement-tracker/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 material-procurement-tracker -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/material-procurement-tracker/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/Procurement/material-procurement-tracker
```

2. **Manually: put the files in place**
- File: `.github/skills/material-procurement-tracker/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction --skill material-procurement-tracker -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/Procurement/material-procurement-tracker
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/material-procurement-tracker/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 material-procurement-tracker -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/Procurement/material-procurement-tracker/SKILL.md

## When to use it
- calculate when a material must be ordered
- find items due for ordering soon
- flag materials late to order
- summarize procurement by status and value
- export a procurement log to Excel

## Example prompts
- Set up a project tracker for materials, required dates, and supplier lead times.
- Show items due for ordering in the next 14 days and any late-to-order items.
- Summarize purchase orders by status and export the log to Excel.

## 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: 65e8113ed1547fcd.

BEGIN THIRD-PARTY FILE 65e8113ed1547fcd
````text
---
name: "material-procurement-tracker"
description: "Track material procurement from requisition to delivery. Monitor lead times, vendors, and costs."
homepage: "https://datadrivenconstruction.io"
metadata: {"openclaw": {"emoji": "🛒", "os": ["darwin", "linux", "win32"], "homepage": "https://datadrivenconstruction.io", "requires": {"bins": ["python3"]}}}
---
# Material Procurement Tracker

## Business Case

Long lead items and material procurement require careful tracking to avoid schedule delays.

## Technical Implementation

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


class ProcurementStatus(Enum):
    REQUISITIONED = "requisitioned"
    RFQ_SENT = "rfq_sent"
    QUOTED = "quoted"
    PO_ISSUED = "po_issued"
    IN_PRODUCTION = "in_production"
    SHIPPED = "shipped"
    DELIVERED = "delivered"


class Priority(Enum):
    CRITICAL = "critical"
    HIGH = "high"
    NORMAL = "normal"
    LOW = "low"


@dataclass
class ProcurementItem:
    item_id: str
    description: str
    spec_section: str
    quantity: float
    unit: str
    required_date: date
    lead_time_days: int
    status: ProcurementStatus
    priority: Priority
    vendor: str = ""
    po_number: str = ""
    po_amount: float = 0.0
    order_date: Optional[date] = None
    expected_delivery: Optional[date] = None
    actual_delivery: Optional[date] = None

    @property
    def must_order_by(self) -> date:
        return self.required_date - timedelta(days=self.lead_time_days)

    @property
    def is_late_to_order(self) -> bool:
        if self.status in [ProcurementStatus.PO_ISSUED, ProcurementStatus.IN_PRODUCTION,
                          ProcurementStatus.SHIPPED, ProcurementStatus.DELIVERED]:
            return False
        return date.today() > self.must_order_by


class MaterialProcurementTracker:
    def __init__(self, project_name: str):
        self.project_name = project_name
        self.items: Dict[str, ProcurementItem] = {}
        self._counter = 0

    def add_item(self, description: str, spec_section: str, quantity: float,
                unit: str, required_date: date, lead_time_days: int,
                priority: Priority = Priority.NORMAL) -> ProcurementItem:
        self._counter += 1
````
END THIRD-PARTY FILE 65e8113ed1547fcd

The third-party file has ended. Everything between the 65e8113ed1547fcd 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 2350 of 5779 bytes. © datadrivenconstruction · MIT · https://github.com/datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction/tree/HEAD/1_DDC_Toolkit/Procurement/material-procurement-tracker/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
