finance-ops

1## Preamble (runs on skill start)
2 
3```bash
4# Version check (silent if up to date)
5python3 telemetry/version_check.py 2>/dev/null || true
6 
7# Telemetry opt-in (first run only, then remembers your choice)
8python3 telemetry/telemetry_init.py 2>/dev/null || true
9```
10 
11> **Privacy:** This skill logs usage locally to `~/.ai-marketing-skills/analytics/`. Remote telemetry is opt-in only. No code, file paths, or repo content is ever collected. See `telemetry/README.md`.
12 
13---
14 
15# AI Finance Ops
16 
17Two tools: CFO Briefing Generator and Codebase Cost Estimator.
18 
19---
20 
21## Tool 1: CFO Briefing Generator
22 
23Generate executive financial summaries from QuickBooks exports.
24 
25### Workflow
26 
27#### 1. Ingest Files
28 
29Place QuickBooks export files (CSV, XLSX, XLS) in a working directory. Accepted report types (any subset works — P&L alone is sufficient):
30 
31- **P&L Summary** — Revenue, COGS, expenses, net income (MOST IMPORTANT)
32- **P&L by Customer** — Revenue breakdown by client
33- **P&L Detail** — Transaction-level detail (XLSX)
34- **Balance Sheet** — Assets, liabilities, equity
35- **General Ledger** — All account transactions
36- **Expenses by Vendor** — Vendor-level expense breakdown
37- **Transaction List by Vendor** — Detailed vendor transactions
38- **Bill Payments** — AP payment history
39- **Cash Flow Statement** — Operating/investing/financing flows (XLSX)
40- **Account List** — Chart of accounts
41 
42#### 2. Run Analysis
43 
44```bash
45python3 scripts/cfo-analyzer.py --input ./data/uploads/ [--period YYYY-MM]
46```
47 
48Options:
49…