Agent skill · software engineering · jeremylongshore
fondo-sdk-patterns
Build internal tools that consume Fondo financial data exports with
Why this skill is useful
Adds executable scripts and integration patterns for Fondo financial data exports and QuickBooks synchronization that are not widely available.
What it needs
Requires typescript installed locally. Requires fondo account access. About 3k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
Fondo SDK Patterns Overview Production-ready patterns for integrating with Fondo tax and accounting data. Fondo is a managed bookkeeping platform that syncs through QuickBooks Online and payroll providers. Integration uses the FONDOAPIKEY-authenticated REST endpoints for exports, the QuickBooks Online API for GL data, and structured CSV parsing with Zod validation for bulk imports. Prerequisites Scoped credentials, authorized source/destination mappings, synthetic fixtures, and a designated finance-data owner. Schema validation, idempotent import design, redacted diagnostics, and professional review for financial conclusions. Instructions 1. Validate source schema and field allowlists before parsing or forwarding data. 2. Use opaque operation IDs, bounded retries, and reconciliation gates to prevent duplicate or partial imports. 3. Quarantine unknown fields and mismatches for finance review rather than broadening data access. Output Produce a client-validation receipt with contract/fixture version, aggregate schema and reconciliation outcome, operation ID, owner, and redacted failure reference. Do not log transactions, accounts, tax/payroll data, or tokens. Examples Import a fictional aggregate ledger fixture into staging, repeat it under the same operation ID, and verify duplicate suppression. Introduce an unexpected field and confirm the parser blocks it for review without revealing record contents. Singleton Client Error Wrapper Request Builder Response Types Testing Utilities Error Handling Pattern When to Use Example --------- ------------- --------- safeCall wrapper All Fondo API calls Structured error logging with operation context Retry on 429 Bulk transaction exports 5s backoff before retry Zod validation CSV import parsing Reject malformed rows before DB insert Auth validation Client init Fail fast on missing FONDOAPIKEY Resources Fondo Next Steps Apply patterns in fondo-core-workflow-a.
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/fondo-sdk-patterns