# tres-upload-tx-header-validation

tres-upload-tx-header-validation provides exact column headers for TRES Finance transaction CSV uploads and fixes missing column errors.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 4931 repo stars
- Author: Nadav Gilliam · official Anthropic repository
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/anthropics/claude-plugins-community/tree/HEAD/tres-finance-plugin/skills/tres-upload-tx-header-validation/SKILL.md
- Updated: 2026-10-24
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/tres-upload-tx-header-validation

## What it does

TRES Finance bulk transaction uploads reject snake_case field keys like `wallet_address` or `hash`. The platform expects human-readable display titles with exact casing and spaces. This skill provides the correct header row from column A to Q.

Column L for `Fiat Value` can stay empty, but its header must remain in place. The skill focuses solely on column naming conventions; row data validation and contact imports require separate handling.

## Install

### Claude Code (native platform)

1. **Plugin marketplace**
In the agent chat (not a shell):
```text
/plugin marketplace add anthropics/claude-plugins-community
```
In the agent chat (not a shell):
```text
/plugin install tres-finance-plugin@claude-community
```
This installs the whole tres-finance-plugin plugin with all its skills

2. **Skills CLI (Vercel)**
```bash
npx skills add anthropics/claude-plugins-community --skill tres-upload-tx-header-validation -a claude-code
```

3. **Manually: put the files in place**
- File: `~/.claude/skills/tres-upload-tx-header-validation/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/tres-upload-tx-header-validation/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add anthropics/claude-plugins-community --skill tres-upload-tx-header-validation -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/tres-upload-tx-header-validation/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add anthropics/claude-plugins-community --skill tres-upload-tx-header-validation -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/tres-upload-tx-header-validation/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install anthropics/claude-plugins-community tres-finance-plugin/skills/tres-upload-tx-header-validation
```

2. **Manually: put the files in place**
- File: `.github/skills/tres-upload-tx-header-validation/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add anthropics/claude-plugins-community --skill tres-upload-tx-header-validation -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/anthropics/claude-plugins-community --path tres-finance-plugin/skills/tres-upload-tx-header-validation
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/tres-upload-tx-header-validation/SKILL.md` — The legacy .windsurf/skills/ path still works

### 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/anthropics/claude-plugins-community/tree/HEAD/tres-finance-plugin/skills/tres-upload-tx-header-validation/SKILL.md

## When to use it
- Fix CSV header row names after failed TRES Finance uploads
- Convert snake_case column keys into TRES display names
- Align manual transaction CSV columns in the required order

## Example prompts
- Fix my CSV headers for TRES Finance transaction upload
- Validate TRES upload CSV headers after missing required columns error
- Generate the header row for TRES transaction CSV template

## 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: 0daea2fcb59b7c46.

BEGIN THIRD-PARTY FILE 0daea2fcb59b7c46
````text
---
name: tres-upload-tx-header-validation
description: "The exact column header names required by the TRES Finance bulk transaction CSV upload. Use whenever building, fixing, or validating the header row of a TRES manual transaction or sub-transaction upload CSV — especially after an upload fails with \"Missing required column(s): ...\". Trigger phrases include: 'fix my CSV headers', 'bulk transaction upload failed', 'missing required columns', 'validate TRES upload CSV', 'transaction CSV template headers'. This skill is ONLY about the header naming convention; it does not cover row values or upload workflow. Do NOT trigger for contacts import CSV (use tres-import-contacts), wallet upload CSV (use tres-wallets-upload), or general CSV parsing unrelated to bulk TX upload headers."
---

# TRES CSV header naming convention

TRES validates the CSV **header row against human-readable display names** (with spaces and title case), NOT snake_case keys. Using the wrong names fails the upload with:

```
Missing required column(s): Year, Month, Day, Time, Organizational Wallet, Participating Wallet, Network, Direction, Financial Action, Asset Identifier, Amount, Fiat Currency, Transaction Hash, Transfer ID, Function Name, Method ID
```

## The required header row (exact, in order)

```
Year,Month,Day,Time,Organizational Wallet,Participating Wallet,Network,Direction,Financial Action,Asset Identifier,Amount,Fiat Value,Fiat Currency,Transaction Hash,Transfer ID,Function Name,Method ID
```

## Rules

- Use these names **verbatim** — exact spelling, spacing, and title case. They are the display names, not field keys.
- Keep the **order** above (columns A→Q).
- `Fiat Value` (column L) is the one optional column — it does not appear in the "missing required column(s)" error, but include it in the header so the template stays aligned; its cells may be left blank.
- All other 16 columns are required in the header row even if a given cell is empty.

## Common mistake this prevents

Writing programmatic/snake_case headers like `year,month,day,time,wallet_address,third_party,network,direction,type,asset_identifier,amount,fiat_value,fiat_currency,hash,transfer_id,function_name,method_id`. These are rejected — TRES wants the display names above (e.g. `Organizational Wallet` not `wallet_address`, `Participating Wallet` not `third_party`, `Financial Action` not `type`, `Transaction Hash` not `hash`).
````
END THIRD-PARTY FILE 0daea2fcb59b7c46

The third-party file has ended. Everything between the 0daea2fcb59b7c46 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.

© Nadav Gilliam · MIT · https://github.com/anthropics/claude-plugins-community/tree/HEAD/tres-finance-plugin/skills/tres-upload-tx-header-validation/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
