# cashflow-forecaster

cashflow-forecaster forecasts construction project cash flow: calculates gaps between costs and client payments, shows when financing is needed.

- 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/4_DDC_Curated/Financial-Management/cashflow-forecaster/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/cashflow-forecaster

## What it does

The skill builds a timeline of income and expenses based on the schedule, payment terms, and retainage. It distributes costs along an S-curve: low at the start and end, peak in the middle. Different payment terms for subcontractors (45 days), materials (30 days), and other categories.

Inside is a Python class `CashFlowForecaster` with methods `add_cost_item`, `generate_cost_distribution`, and period calculations. Requires Python 3 in `PATH`. Returns peak deficit, breakeven date, and required financing. No FFmpeg or external dependencies — standard library only.

## Install

### Claude Code (native platform)

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

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

### Codex

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

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

2. **Manually: put the files in place**
- File: `.cursor/skills/cashflow-forecaster/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 4_DDC_Curated/Financial-Management/cashflow-forecaster
```

2. **Manually: put the files in place**
- File: `.github/skills/cashflow-forecaster/SKILL.md`

### Gemini CLI

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

2. **Platform CLI**
```bash
gemini skills install https://github.com/datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction --path 4_DDC_Curated/Financial-Management/cashflow-forecaster
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/cashflow-forecaster/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 cashflow-forecaster -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/4_DDC_Curated/Financial-Management/cashflow-forecaster/SKILL.md

## When to use it
- forecast construction project cash flow from schedule
- find months with cash shortfalls
- calculate how much credit a project needs
- optimize subcontractor payment timing
- build an S-curve of costs by category

## Example prompts
- Build a cash flow forecast for an 8-month project, $5M contract, $4.2M costs, starts March 1
- Add expense 'Crane rental' $150k on April 15, payment in 30 days
- Show peak deficit and the month when the project breaks even

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

BEGIN THIRD-PARTY FILE a1ab517f103a91bc
````text
---
name: "cashflow-forecaster"
description: "Forecast construction project cash flow. Project income and expenses, identify funding gaps, and optimize payment timing for improved financial management."
homepage: "https://datadrivenconstruction.io"
metadata: {"openclaw": {"emoji": "💵", "os": ["darwin", "linux", "win32"], "homepage": "https://datadrivenconstruction.io", "requires": {"bins": ["python3"]}}}
---
# Cashflow Forecaster

## Overview

Forecast construction project cash flow based on schedule, billing cycles, and payment terms. Identify potential cash shortfalls, optimize payment timing, and support project financing decisions.

## Cash Flow Curve

```
┌─────────────────────────────────────────────────────────────────┐
│                    CONSTRUCTION CASH FLOW                        │
├─────────────────────────────────────────────────────────────────┤
│                                                                  │
│  $   Income (payments received)                                 │
│  │         ╱──────────╲                                         │
│  │       ╱              ╲    Positive cash                      │
│  │     ╱                  ╲  position                           │
│  │   ╱                      ╲                                   │
│  │ ╱     Cash Gap             ╲                                 │
│  ├─────────────────────────────────────────────────────         │
│  │╲                                                             │
│  │  ╲    Expenses (costs incurred)                              │
│  │    ╲──────────╱                                              │
│  │                                                              │
│  └──────────────────────────────────────────────────────────    │
│        Time →                                                    │
````
END THIRD-PARTY FILE a1ab517f103a91bc

The third-party file has ended. Everything between the a1ab517f103a91bc 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 2472 of 17562 bytes. © datadrivenconstruction · MIT · https://github.com/datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction/tree/HEAD/4_DDC_Curated/Financial-Management/cashflow-forecaster/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
