From financial-planning
Contains verified 4-tier benchmarking data source hierarchy (RMA/BizMiner/IRS SOI/SEC EDGAR with 5-criteria peer group selection and quartile ranking), management reporting KPI computation engine (accounting expressions, pro-rata budget comparison, PDF/XLSX/dashboard output), and price/volume/mix/timing variance decomposition formulas with materiality thresholds. Budget-vs-actual analysis, common-size P&L and balance sheet, financial ratio comparison (DSO, margins, current ratio, debt-to-equity, ROIC), executive commentary, management reporting. Consult when computing BvA variances, decomposing unfavorable cost or revenue drivers, designing KPI dashboards with accumulation methods, benchmarking client ratios against industry peers by NAICS code, producing board-ready management reports, writing variance narrative, or comparing effective tax rates to industry norms for C-corporations.
How this skill is triggered — by the user, by Claude, or both
Slash command
/financial-planning:variance-analysisThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Operational skill for budget-vs-actual analysis, KPI computation, industry benchmarking,
Operational skill for budget-vs-actual analysis, KPI computation, industry benchmarking, and management report production for C-corporations. This skill turns raw financial data into actionable performance insights for management, lenders, and boards.
Sign convention matters: for revenue lines, positive variance is favorable (beat budget); for expense lines, positive variance is unfavorable (overspent). Always label F/U (favorable/unfavorable) explicitly rather than relying on sign alone.
Not every variance warrants analysis. Apply dual threshold (both must be met for immaterial classification):
Variances below both gates can be noted but need not be explained. Variances exceeding either gate require decomposition and narrative explanation.
When comparing actuals to budget, periods must align precisely. Budget amounts stored on a per-period basis should be pro-rated if the reporting period does not match the budget period exactly:
adjusted_budget = annual_budget * (reporting_days / total_days)For MIS-style reporting systems, pro-rata temporis adjustment handles this automatically:
when a budget item spans a longer period than the report column, the system computes
amount * overlap_days / item_total_days for sum-accumulation KPIs and weighted averages
for avg-accumulation KPIs.
Break aggregate variances into actionable components. The goal is to answer "why did we miss?" not just "by how much?"
Measures the impact of rate/price differences holding volume constant.
Price variance = (Actual price - Budget price) * Actual quantity
Examples: hourly billing rate changes, material cost increases, salary rate differences.
Measures the impact of quantity/activity differences holding price constant.
Volume variance = (Actual quantity - Budget quantity) * Budget price
Examples: units sold above/below plan, billable hours over/under target, headcount changes.
Measures the impact of product/service/channel mix shifts on blended margins.
Mix variance = (Actual mix % - Budget mix %) * Actual total volume * Budget margin per unit
Relevant when the entity sells multiple products/services at different margins. A shift toward lower-margin services reduces blended margin even if total volume meets budget.
Measures the impact of revenue/expense recognition timing differences between periods.
Common causes: accelerated or deferred revenue recognition, prepaid expense amortization timing, seasonal patterns not reflected in straight-line budget allocation. Timing variances often net to zero over the full year but distort monthly and quarterly reports.
For a complete explanation, decompose in order: (1) volume, (2) price, (3) mix. Residual after these three is the interaction effect (price * volume cross-term) which is typically small and can be allocated proportionally or disclosed as "interaction."
Choose KPIs that connect operational activity to financial outcomes. A well-designed KPI set covers four perspectives:
For C-corporations, also track: effective tax rate (tax expense / pre-tax income), cash tax rate, return on equity (ROE), return on invested capital (ROIC = NOPAT / invested capital).
Each KPI should be defined with:
num), percentage (pct), or string (str)diff (absolute delta), pct (percentage change), or nonesum (additive across periods), avg (weighted average), noneKPIs can reference GL account balances directly or build on other KPIs:
gross_profit / net_revenue)operating_income / net_revenue if net_revenue > 0 else None)balance_sheet.current_assets / balance_sheet.current_liabilities)For dashboard-style KPI presentation:
hide_empty) or are intermediate calculations (hide_always)Choose the benchmarking source based on budget and precision needs:
Peer group quality determines benchmarking validity. Select in priority order:
Position each client ratio within the industry distribution: upper quartile (top 25%), median, lower quartile (bottom 25%).
Raw numbers without context are meaningless to most clients. Translate:
Express every line item as a percentage of a base to enable cross-period and cross-company comparison regardless of size differences.
Compare common-size percentages across periods to surface:
A standard management report (MIS package) includes:
Write variance commentary in this pattern:
Avoid: vague language ("slightly above"), unexplained jargon, presenting raw numbers without context, burying bad news in footnotes.
For pulling actuals and comparative financial data:
qbo-integration:qbo-reportingRead these for deeper detail on specific topics:
references/industry-benchmarking.md -- Complete benchmarking methodology and data source guide. Read "Data Source Hierarchy" for detailed coverage of RMA, BizMiner, IBISWorld, IRS SOI, and public comparables with strengths and limitations of each. Read "Peer Group Selection" for the 5-criteria prioritized selection framework. Read "Financial Ratio Categories" for full definitions and interpretation notes across liquidity, leverage, efficiency, and profitability ratio families. Read "Analysis and Presentation" for quartile ranking methodology, trend vs point-in-time guidance, and narrative context patterns. Read "Limitations and Caveats" before presenting any benchmarking analysis.
references/management-reporting-engine.md -- Management reporting engine architecture for KPI-based financial reports. Read "Data Model" for KPI row definition (type, compare method, accumulation method, expressions, sub-KPIs, auto-expand accounts, style overrides). Read "Expression Engine" for accounting expression syntax (bal/deb/crd/pbal/nbal with period/initial/ending modes, account selectors, move line domains) and Python expression patterns (cross-KPI references, conditionals, subreport access). Read "Report Computation Flow" for the full matrix computation pipeline (compute_matrix, add_column, expression evaluation, recompute queue, comparison/sum column generation). Read "Data Sources" for actuals, alternative move line models, budget-by-KPI with pro-rata temporis, and budget-by-account sources. Read "Output Formats" for PDF/XLSX/dashboard rendering details including style conversion and drill-down mechanics.
For upstream data sources:
financial-planning:budgeting-forecasting for the budget baseline used as comparison target in BvA analysis, budget governance workflow (draft/confirmed/validated), and time-proportional pacing computationaccounting-foundation:financial-statements for actuals (P&L, balance sheet, cash flow, trial balance), GAAP presentation rules, ratio analysis definitions, common-size analysis methodology, and year-end close workflowqbo-integration:qbo-reporting for accounting system report endpoints (P&L, Balance Sheet, Cash Flow, General Ledger), report parameters, comparative reporting, and Excel exportFor downstream consumers:
financial-planning:strategic-advisory for board reporting, M&A due diligence, and strategic decisions that consume variance analysis and benchmarking outputfinancial-planning:financial-modeling for 3-statement models that project future performance and reference historical variance patternsnpx claudepluginhub aeyeops/aeo-basis-plugin-marketplace --plugin financial-planningDecomposes financial variances into price/volume/mix/headcount drivers with formulas, narratives, examples, and waterfall analysis for budget vs. actual or period-over-period changes.
Analyzes budget vs actual variances in Excel spreadsheets with automated drill-down, root cause identification, materiality thresholds, and waterfall charts for executive reporting.
Generates variance commentary for P&L and balance-sheet lines, comparing current vs prior period and vs budget with driver explanations. Useful for month-end close and management reporting.