# payment-application-generator

payment-application-generator generates AIA-style payment applications: tracks schedule of values, calculates retention, and produces payment documentation.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 117 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/Cost-Management/payment-application-generator/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/payment-application-generator

## What it does

The skill builds payment applications in AIA format (G702/G703 forms) from a schedule of values. It tracks completed work and stored materials, calculates retention for each line item, and computes the remaining contract balance. Approved change orders can be added to an existing item or created as a separate line.

Requires Python 3 in `PATH`. The skill provides `SOVItem`, `PaymentApplication`, and `PaymentApplicationGenerator` classes that store line item data, compute percent complete, and produce totals with retention deducted. Default retention is set at ten percent and can be customized when initializing the generator.

## Install

### Claude Code (native platform)

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

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

### Codex

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

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

2. **Manually: put the files in place**
- File: `.cursor/skills/payment-application-generator/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/Cost-Management/payment-application-generator
```

2. **Manually: put the files in place**
- File: `.github/skills/payment-application-generator/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction --skill payment-application-generator -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/Cost-Management/payment-application-generator
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/payment-application-generator/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 payment-application-generator -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/Cost-Management/payment-application-generator/SKILL.md

## When to use it
- generate an AIA G702/G703 payment application from a schedule of values
- calculate retention and contract balance
- track completed work and stored materials for a billing period
- add a change order to an existing line or create a new one
- output percent complete for each item and balance due

## Example prompts
- Create a payment application for January: contract sum 500k, retention 5%, items from `sov.csv`
- Add a change order for 50k to item 03, description 'Additional facade work'
- Generate application number 3 from March 1 to March 31, item progress in `progress_march.json`

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

BEGIN THIRD-PARTY FILE af45fd7f9a4c6d87
````text
---
name: "payment-application-generator"
description: "Generate AIA-style payment applications. Track schedule of values, calculate retention, and produce payment documentation."
homepage: "https://datadrivenconstruction.io"
metadata: {"openclaw": {"emoji": "💰", "os": ["darwin", "linux", "win32"], "homepage": "https://datadrivenconstruction.io", "requires": {"bins": ["python3"]}}}
---
# Payment Application Generator

## Business Case

### Problem Statement
Payment applications are error-prone:
- Manual calculations cause mistakes
- Retention tracking is complex
- Inconsistent documentation
- Delayed submissions affect cash flow

### Solution
Automated payment application generation with schedule of values tracking, retention calculations, and standard format output.

### Business Value
- **Accuracy** - Eliminate calculation errors
- **Speed** - Faster billing cycle
- **Cash flow** - Timely payments
- **Compliance** - Standard documentation

## Technical Implementation

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


class SOVStatus(Enum):
    """Schedule of Values item status."""
    NOT_STARTED = "not_started"
    IN_PROGRESS = "in_progress"
    COMPLETE = "complete"
    STORED_MATERIAL = "stored_material"


@dataclass
class SOVItem:
    """Schedule of Values line item."""
    item_number: str
    description: str
    scheduled_value: float
    work_completed_previous: float
    work_completed_current: float
    materials_stored_previous: float
    materials_stored_current: float
    total_completed_previous: float

    @property
    def total_completed_current(self) -> float:
        """Total completed and stored this period."""
        return (self.work_completed_previous + self.work_completed_current +
                self.materials_stored_previous + self.materials_stored_current)

    @property
    def percent_complete(self) -> float:
        """Percent of scheduled value complete."""
        if self.scheduled_value == 0:
            return 0
````
END THIRD-PARTY FILE af45fd7f9a4c6d87

The third-party file has ended. Everything between the af45fd7f9a4c6d87 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 2113 of 14458 bytes. © datadrivenconstruction · MIT · https://github.com/datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction/tree/HEAD/1_DDC_Toolkit/Cost-Management/payment-application-generator/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
