Anomaly variance explanation
Explains material changes in a business metric by decomposing period, volume, price, mix, and data-quality effects, then ranks evidence-backed causes in a cited analysis sheet and management memo. Use for KPI variance reviews, monthly business reviews, forecast misses, anomaly investigation, and driver analysis.
Published Aug 21, 2026 · Updated Aug 26, 2026
Requirements
Map KPI and transaction columns, identifiers, dimensions, units, and source references. Add the metric definition, comparison hierarchy, materiality threshold, and rounding tolerance. Define calendar, currency, timezone, and cancellation treatment.
Skill document
The full SKILL.md your agent reads and follows.
Anomaly variance explanation
Purpose
Explain why a reported metric differs materially from its comparison value. The output separates arithmetic drivers from contextual evidence, ranks causes by quantified contribution, and gives a reviewer a traceable basis for follow-up.
Scope
Analyze one metric, comparison period or plan, and the dimensions that explain its movement. Cover volume, rate or price, mix, timing, data completeness, and documented operational events. Excluded: changing source data, inventing a target, forecasting beyond the supplied evidence, or assigning corrective work to people.
Data basis
- KPI table with
metric,period,actual,plan_or_prior,dimension,unit, andsource_row_id. - Transaction or event table with
date,quantity,price_or_rate,category,customer_or_account, andstatus. - Forecast, budget, calendar, launch, outage, or pricing documents in scope.
- Metric definition and materiality threshold supplied by the company.
Result
Produce a variance bridge sheet with one row per metric segment and a memo that states the absolute and percentage variance, quantified drivers, evidence citations, confidence, and unresolved data gaps.
Quality criteria
- The bridge reconciles actual minus comparison to the sum of classified drivers, subject to a stated rounding tolerance.
- Every driver names its formula, source row or document page, and confidence level.
- The same period, unit, currency, and population are used on both sides of the comparison.
- Timing effects, excluded rows, and unproven hypotheses remain visibly separate.
- No explanation is called causal without supporting evidence.
Instructions
Use the metric definition and company materiality rule before interpreting movement. Calculate absolute change as actual - comparison and relative change only when the comparison denominator is non-zero. Decompose revenue-like measures into volume, rate, and mix only when the source fields support that decomposition; otherwise label the residual. Rank explanations by quantified contribution, then evidence strength, and label a contribution as “hypothesis” when it is supported only by correlation or a dated event note. Cite metric-table rows for figures and document section or page for contextual claims. Preserve negative, zero, and missing values rather than converting them to blanks.
Adapt before use
- Map KPI, transaction, dimension, date, unit, and source-ID columns to the company data model.
- Add the metric definition, comparison hierarchy, materiality threshold, and rounding tolerance.
- Define currency conversion, timezone, fiscal calendar, and treatment of cancellations or late postings.
Related skills
- Sync a spreadsheet into a record type
Loads an uploaded spreadsheet into a record type of the workspace with the bulk sync tool, previewing the changes before writing. Use for master data imports, periodic refreshes of a table, or migrating a list from Excel into records.
- Data migration field mapping
Maps source-system fields to a target data model for migration, documenting transformations, requiredness, value translations, identifiers, validation rules, and unresolved collisions. Use for CRM migrations, ERP imports, warehouse loads, application replacement, and controlled spreadsheet-to-system field mapping.
- Dataset Quality Assessment
Dataset Quality Assessment converts table schema, column types, null policy, primary and foreign keys into profiling report and defect register with field metrics, duplicate groups, invalid values, orphan keys, temporal gaps, and severity, with cited evidence, explicit rules, and unresolved exceptions. Use for dataset quality assessment, recurring review, and decision preparation.
- Document-set extraction table
Extracts a defined field set from every same-kind document in a folder into a structured sheet with source citations, confidence flags, and a separate exceptions register. Use for batch contract, invoice, CV, or policy extraction, document-set coding, field harvesting, and cited folder-wide data capture.