audit-xls

Audits spreadsheet formulas and financial models for errors, hardcodes, and integrity failures.

Updated Sep 17, 2026
One-click install
npx skills add https://github.com/hkw2028/toy-project --skill audit-xls-hkw2028
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: audit-xls
Source: https://github.com/hkw2028/toy-project/tree/main/.agents/skills/audit-xls
Command: npx skills add https://github.com/hkw2028/toy-project --skill audit-xls-hkw2028

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Spreadsheets and financial models silently accumulate formula errors, hardcoded overrides, and broken links that produce wrong outputs. This Skill systematically audits a selection, sheet, or entire workbook to find mistakes before they reach a client or investment committee. ## Core Features & Use Cases - Formula-Level Checks: Detects #REF!/#VALUE!/#DIV/0! errors, hardcodes inside formulas, inconsistent patterns, off-by-one ranges, pasted-over formulas, circular references, and unit mismatches. - Financial Model Integrity: For full-model scope, verifies BS balance, cash tie-out, RE rollforward, D&A/CapEx matching, and working capital sign conventions across 3-statement, DCF, LBO, and merger models. - Severity-Ranked Reporting: Outputs a findings table with Critical/Warning/Info severity, cell references, and suggested fixes — reporting first without changing anything. - Use Case: Before sending an LBO model to your IC, ask for a model-scope audit to confirm the balance sheet balances every period, the cash sweep ties to debt paydown, and no hardcoded overrides hide in the assumptions. ## Quick Start Audit this spreadsheet at model scope and report any formula errors, balance sheet breaks, or hardcoded values.

Frequently Asked Questions about audit-xls

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check an Excel spreadsheet for formula errors?

Run a formula audit that scans for #REF!, #VALUE!, #N/A, #DIV/0!, and #NAME? errors, plus hardcodes inside formulas, inconsistent formulas that break row/column patterns, and off-by-one SUM or AVERAGE ranges. Scope the audit to a selection, one sheet, or the whole workbook.

How to audit a financial model before sending it to a client?

Use a full model-scope audit covering structural review, balance sheet balance per period, cash flow tie-out to the BS, retained earnings rollforward, and logic sanity checks like growth rates and terminal value dominance. Report critical issues first and fix only after review.

Why doesn't my balance sheet balance in my 3-statement model?

Common causes are working capital sign errors, depreciation not matching the PP&E schedule, debt principal payments not matching the maturity schedule, or a broken retained earnings rollforward. Quantify the gap per period and trace where it first breaks before fixing anything downstream.

What are common DCF model mistakes to check for?

Frequent DCF bugs include discounting with the wrong period convention, terminal value not discounted back, WACC using book instead of market values, levered FCF including interest expense, and double-counted tax shields. Terminal value exceeding roughly 75% of enterprise value is a yellow flag.

Can a spreadsheet audit detect circular references?

Yes. The audit identifies both intentional circularity, such as the interest-debt-cash loop in LBO models where an iteration toggle should exist, and accidental loops, which it traces and flags with suggestions for breaking the cycle.

What are the limitations of auditing spreadsheets with VBA macros?

Macro-driven calculations cannot be fully audited from formulas alone, since logic lives in VBA code rather than cells. The audit notes any macro-dependent calculations so reviewers know which outputs require separate code inspection.