coreyhaines31/makerskills / skills/company-cfo
company-cfo
VerifiedMonthly CFO workflow for a company or agency — pull raw data from bank + payment processor + payroll + expense management, categorize and reconcile, compute end-of-month cash via transaction-sum method, update a scenario projector for forward forecasting, write the monthly snapshot report, surface decisions to leadership. Modes — monthly (default; the standing report), weekly (thin cash pulse), scenario (ad-hoc modeling in the projector), pickup (resume where the prior run left off). Anonymized team-scope sibling to personal-cfo (which handles personal household finances). Composes with company-brain (report gets stored + wiki-indexed there), toolify (wire company-specific data sources), loopify (schedule the monthly + weekly runs). Triggers on "/company-cfo," "/cfo," "monthly cash report," "do the CFO snapshot," "CFO monthly," "let's run CFO," "cash projection," "runway forecast," "monthly financials," "cash pulse."
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 15.8 KB |
| references/categorization.md | markdown | 4.1 KB |
| references/company-config-template.md | markdown | 4.8 KB |
| references/eom-cash-methodology.md | markdown | 5.2 KB |
| references/report-template.md | markdown | 5.2 KB |
| references/scenario-projector.md | markdown | 6.7 KB |
| references/traps.md | markdown | 6.5 KB |
references/company-config-template.md
View on GitHub# Company config template
Copy this to `${COMPANY_CFO_ROOT}/AGENTS.md` (and symlink `CLAUDE.md` to it for Claude Code) when seeding a new company's CFO workflow. Fill in placeholders with your actuals.
The file becomes the source of truth for HOW your company computes its financials. The `company-cfo` skill reads this first before every run.
## Also seed a `.gitignore` in the repo root
Raw financial data (bank transaction dumps, payroll payloads, expense-manager exports) MUST NOT be committed. Before running the CFO workflow for the first time, verify the repo has a `.gitignore` with at minimum:
```
# Raw financial data — never commit
data/
*.jsonl
*.env
*.env.local
.mcp.json
```
The `company-cfo` skill's Phase 7 seeds this automatically if missing, but doing it manually at repo setup is safer.
---
```markdown
# <Company Name> CFO — methodology + config
## Structure
- **Legal form**: <LLC / C-Corp / S-Corp / other>
- **Fiscal year**: <calendar / July-June / other>
- **Owners / partners / leadership**: <names + roles>
- **Number of monthly distributions expected**: <N>
- **Cash floor**: $<X>K (below this, defer distributions + review expenses)
## Data sources
| Source | Tool | Access | Notes |
|---|---|---|---|
| Bank / cash | <e.g. Mercury CLI> | `<install> ; <auth>` | Cash accounts to include: <list account labels> |
| Payment processor | <e.g. Stripe> | `<key location>` | MRR source of truth |
| Alt revenue | <e.g. Paddle, direct invoicing> | <access> | Note: not visible in payment processor |
| Payroll (contractors) | <e.g. Plane, Deel> | `<key location>` | Currency: use `source_amount` for base-currency cost |
| Payroll (W-2) | <e.g. Gusto, Rippling> | <access> | Includes employer taxes + benefits |
| Expense management | <e.g. Ramp, Brex> | `<CLI or API>` | Cash-out timing lives in bank (RMPR / equivalent debits) |
## Cash accounts
Filter transactions to these accounts only (exclude credit card / debt / escrow):
- Checking ••<last 4> (primary operating)
- Savings ••<last 4> (reserves)
- <any other cash-holding accounts>
Exclude: internal transfers (Checking ↔ Savings), credit card account (debt-side, double-counts autopay flows).
## Categorization
| Category | What counts here |
|---|---|
| **distributions** | ACHs to partner accounts <account digits or names> |
| **team** | All payroll debits + payroll platform fees |
| **software** | Corporate card autopay (dominated by SaaS) |
| **reimbursements** | Expense-management outflows paid to team |
| **benefits** | Healthcare, retirement, dental, vision |
| **other** | Rent, CPA, insurance, professional services, one-times |
Add categories only at fiscal year-end (see `references/categorization.md`).
## Distribution mechanics
- **Frequency**: <monthly / quarterly / ad-hoc>
- **Formula**: <fixed amount / % of profit / other>
- **Recipients**: <named partners + account digits>
- **Constraints**: <cash floor, retention buffer, deferrals>
## MRR + revenue
- **Primary source**: <Stripe / other>
- **Secondary sources**: <alt billing platforms — always include, they're invisible in the primary>
- **Processing fee assumption**: ~<X>% (default 3% for Stripe). Report MRR NET of fees, not gross.
- **Churn tracking**: <how you track — Stripe events, manual log, other>
## Payroll notes
- **Contractor tool**: <tool>. Currency: use `source_amount` for base-currency cost. `destination_amount` is in worker's payout currency (e.g. JPY, EUR, GBP).
- **W-2 tool**: <tool>. Includes employer taxes + benefits in the total.
- **Held deductions**: expect ~$<X> residual between bank total and payroll tool total.
## Traps documented for this company
Add as they're discovered — this list is company-specific muscle memory:
- <e.g. "The IO autopay double-counts if we include the credit card account. Cash accounts only.">
- <e.g. "Contractor <Name>'s payments come through in JPY. Use source_amount.">
- <e.g. "Vendor <Name> revenue is invisible in Stripe. Add from bank inflows manually.">
## Reports
- **Monthly**: `reports/monthly/YYYY-MM.md`
- **Weekly cash pulse**: `reports/weekly/YYYY-WW.md`
- **Scenarios**: `reports/scenarios/YYYY-MM-DD-<question>.md`
## Scenario projector
- **Location**: `scenarios/index.html` (served via `scenarios/serve.sh` on port <port>)
- **Structure**: 3 historical months + TODAY + 7 forward months
- **Update cadence**: end of each monthly run
## Git workflow
- Branch pattern: `feature/YYYY-MM-snapshot`
- Review: <auto / manual / codex review / other>
- Merge: `gh pr merge --squash --delete-branch`
## Memory note
Running context lives in `company_cfo_<slug>.md` in your memory store (your agent's memory, or `${MAKERSKILLS_MEMORY:-${MAKERSKILLS_CONFIG:-$HOME/.config/makerskills}/memory}/`). Update if:
- Distribution/comp structure changes
- Active sub count or MRR shifts materially
- New revenue stream or new payroll tool
- Cash floor changes
```
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| planning-and-task-breakdownaddyosmani/agent-skillsBreaks work into ordered tasks. Use when you have a spec or clear requirements and need to break work into implementable tasks. Use when a task feels too large to start, when you need to estimate scope, or when parallel work is possible. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| screenpipethedotmack/claude-memSearch screen and audio history recorded by Screenpipe and optionally save selected context into claude-mem. Use when the user asks to recall desktop activity, a meeting, or something seen in another app through Screenpipe. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |
| contact-widgetnexu-io/open-designSelf-contained floating chat widget with welcome screen, social links, meeting button, and message input. Single HTML file, zero dependencies. | Stars: 108k | Updated | Claude CodeCodex | Verified | Install |
| meeting-notesnexu-io/open-designMeeting notes page — title bar with attendees, agenda checklist, decisions block, action items table with owners + dates, and a "next meeting" footer. Use when the brief mentions "meeting notes", "minutes", "1:1 notes", "all-hands recap", or "会议纪要". | Stars: 108k | Updated | Claude CodeCodex | Verified | Install |