# daily-progress-report

daily-progress-report builds daily site progress reports from structured project data, covering work, labor, equipment, and weather. Useful for keeping field records consistent.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 137 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/Analytics/daily-progress-report/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/daily-progress-report

## What it does

This skill creates a daily report for a project, date, weather conditions, temperatures, work activities, labor entries, and equipment. It also stores delays, safety incidents, visitors, and deliveries. Each activity can include planned and actual quantities, a location, crew size, worked hours, and notes.

Its Python implementation defines data structures for activities, labor, equipment, weather, work status, and the report itself. It calculates totals for workers, man-hours, overtime, equipment hours, activity states, safety incidents, and deliveries. An Excel export uses `pandas` with `openpyxl`, while activity status follows the planned-versus-actual quantity.

The skill requires the `python3` executable. Without it, the skill will not start.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction --skill daily-progress-report -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction --skill daily-progress-report -a codex
```

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

2. **Manually: put the files in place**
- File: `.cursor/skills/daily-progress-report/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/Analytics/daily-progress-report
```

2. **Manually: put the files in place**
- File: `.github/skills/daily-progress-report/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction --skill daily-progress-report -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/Analytics/daily-progress-report
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/daily-progress-report/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 daily-progress-report -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/Analytics/daily-progress-report/SKILL.md

## When to use it
- assemble a daily site progress report
- record completed and delayed work activities
- calculate man-hours and overtime
- track equipment hours
- export a report to Excel

## Example prompts
- Create a daily progress report from the project’s work, labor, equipment, and weather data.
- Add a work activity with its planned quantity, actual quantity, location, crew size, and hours worked.
- Calculate the report summary for workers, man-hours, overtime, equipment hours, and delayed activities.

## 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: f8f245fb30dc8291.

BEGIN THIRD-PARTY FILE f8f245fb30dc8291
````text
---
name: "daily-progress-report"
description: "Generate automated daily progress reports from site data. Track work completed, labor hours, equipment usage, and weather conditions."
homepage: "https://datadrivenconstruction.io"
metadata: {"openclaw": {"emoji": "📊", "os": ["darwin", "linux", "win32"], "homepage": "https://datadrivenconstruction.io", "requires": {"bins": ["python3"]}}}
---
# Daily Progress Report Generator

## Business Case

### Problem Statement
Site managers spend hours creating daily reports:
- Manual data collection
- Inconsistent formats
- Delayed submissions
- Missing information

### Solution
Automated daily progress report generation from structured site data inputs.

## Technical Implementation

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


class WeatherCondition(Enum):
    CLEAR = "clear"
    CLOUDY = "cloudy"
    RAIN = "rain"
    SNOW = "snow"
    WIND = "wind"
    EXTREME = "extreme"


class WorkStatus(Enum):
    COMPLETED = "completed"
    IN_PROGRESS = "in_progress"
    DELAYED = "delayed"
    NOT_STARTED = "not_started"


@dataclass
class WorkActivity:
    activity_id: str
    description: str
    location: str
    planned_qty: float
    actual_qty: float
    unit: str
    status: WorkStatus
    crew_size: int
    hours_worked: float
    notes: str = ""


@dataclass
class LaborEntry:
    trade: str
    company: str
    workers: int
    hours: float
    overtime_hours: float = 0


@dataclass
class EquipmentEntry:
    equipment_type: str
    equipment_id: str
    hours_used: float
    status: str  # active, idle, maintenance
    operator: str = ""


@dataclass
class DailyReport:
    report_date: date
    project_name: str
    project_number: str
    weather: WeatherCondition
    temperature_high: float
    temperature_low: float
    work_activities: List[WorkActivity]
    labor: List[LaborEntry]
    equipment: List[EquipmentEntry]
    delays: List[str]
    safety_incidents: int
    visitors: List[str]
    deliveries: List[str]
    prepared_by: str


class DailyProgressReporter:
    """Generate daily progress reports."""
````
END THIRD-PARTY FILE f8f245fb30dc8291

The third-party file has ended. Everything between the f8f245fb30dc8291 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 2202 of 11827 bytes. © datadrivenconstruction · MIT · https://github.com/datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction/tree/HEAD/1_DDC_Toolkit/Analytics/daily-progress-report/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
