# voice-to-report

The voice-to-report skill for Claude Code converts voice recordings into structured construction reports. It activates when field workers need to quickly log site data, such as daily updates or safety observations.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 115 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/3_DDC_Insights/Field-Automation/voice-to-report/SKILL.md
- Updated: 2026-10-19
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/voice-to-report

## What it does

The `voice-to-report` skill automates the creation of construction reports from spoken input. It uses the `Whisper API` for speech-to-text transcription, then `GPT-4o` to structure the information according to predefined schemas. The skill supports daily reports, safety observations, and progress updates.

To function, the skill requires `python3` to be installed and an `OPENAI_API_KEY` environment variable with an OpenAI API key. These are essential for processing audio and generating reports in formats suitable for databases or PDF documents. For instance, an `n8n workflow` can integrate it to receive voice messages via Telegram, save data to `PostgreSQL`, and generate PDFs through an external service.

The skill can automatically detect the language of a recording and translate it to English if needed, preserving construction terminology. This feature benefits field workers who find it easier to speak their observations than to type them on a mobile device.

## Install

### Claude Code (native platform)

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

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

### Codex

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

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

2. **Manually: put the files in place**
- File: `.cursor/skills/voice-to-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 3_DDC_Insights/Field-Automation/voice-to-report
```

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

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction --skill voice-to-report -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction --path 3_DDC_Insights/Field-Automation/voice-to-report
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/voice-to-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 voice-to-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/3_DDC_Insights/Field-Automation/voice-to-report/SKILL.md

## When to use it
- Generating quick site reports
- Transcribing voice notes into text
- Structuring data for daily construction logs
- Creating safety observation and progress reports
- Processing multilingual voice recordings

## Example prompts
- "Convert this voice recording into a daily report"
- "Create a safety report from `safety_note.mp3`"
- "Generate a progress update from the voice message"

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

BEGIN THIRD-PARTY FILE f15b2a48f29ef716
````text
---
name: "voice-to-report"
description: "Convert voice recordings to structured construction reports. Field workers speak, AI transcribes and formats. Supports daily reports, safety observations, progress updates."
homepage: "https://datadrivenconstruction.io"
metadata: {"openclaw": {"emoji": "📱", "os": ["darwin", "linux", "win32"], "homepage": "https://datadrivenconstruction.io", "requires": {"bins": ["python3"], "env": ["OPENAI_API_KEY"]}, "primaryEnv": "OPENAI_API_KEY"}}
---
# Voice to Report

## Overview

Field workers prefer talking over typing. This skill converts voice recordings into structured construction reports using speech-to-text and LLM processing.

## Why Voice?

| Typing | Voice |
|--------|-------|
| Slow on mobile | 3x faster |
| Requires attention | Hands-free |
| Limited in cold/rain | Works anywhere |
| Formal language | Natural expression |
| Short messages | Detailed descriptions |

## Architecture

```
┌─────────────────────────────────────────────────────────────────┐
│                    VOICE TO REPORT PIPELINE                      │
├─────────────────────────────────────────────────────────────────┤
│                                                                  │
│  🎤 Voice      →    📝 Transcribe    →    🤖 Structure    →    📊 Report │
│  Recording         Whisper API           GPT-4o               Formatted  │
│                                                                  │
│  "We finished      "We finished         {                    Daily Report │
│   the foundation    the foundation       "activity":         ──────────── │
│   pour today,       pour today,          "foundation",       Foundation   │
│   about 500         about 500            "quantity": 500,    pour: 500m³  │
````
END THIRD-PARTY FILE f15b2a48f29ef716

The third-party file has ended. Everything between the f15b2a48f29ef716 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 2096 of 8959 bytes. © datadrivenconstruction · MIT · https://github.com/datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction/tree/HEAD/3_DDC_Insights/Field-Automation/voice-to-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
