Excel weekly dashboards at scale
PURPOSE
Designs refreshable Excel dashboards (Power Query + structured tables + validation + pivot reporting).
WHEN TO USE
- TRIGGERS:
- Build me a Power Query pipeline for this file so it refreshes weekly with no manual steps.
- Turn this into a structured table with validation lists and clean data entry rules.
- Create a pivot-driven weekly dashboard with slicers for year and ISO week.
- Fix this Excel model so refresh does not break when new columns appear.
- Design a reusable KPI pack that updates from a folder of CSVs.
- DO NOT USE WHEN…
- You need advanced forecasting/valuation modeling (this skill is for repeatable reporting pipelines).
- You need a BI tool build (Power BI/Tableau) rather than Excel.
- You need web scraping as the primary ingestion method.
INPUTS
- REQUIRED:
- Source data file(s): CSV, XLSX, DOCX-exported tables, or PDF-exported tables (provided by user).
- Definition of ‘week’ (ISO week preferred) and the KPI fields required.
- OPTIONAL:
- Data dictionary / column definitions.
- Known “bad data” patterns to validate (e.g., blank PayNumber, invalid dates).
- Existing workbook to refactor.
- EXAMPLES:
- Folder of weekly CSV exports:
exports/2026-W02/*.csv
- Single XLSX dump with changing columns month to month
OUTPUTS
- If asked for plan only (default): a step-by-step build plan + Power Query steps + sheet layout + validation rules.
- If explicitly asked to generate artifacts:
workbook_spec.md (workbook structure and named tables)
power_query_steps.pq (M code template)
refresh-checklist.md (from assets/)
Success = refresh works after adding a new week’s files without manual edits, and validation catches bad rows.
WORKFLOW
- Identify source type(s) (CSV/XLSX/DOCX/PDF-export) and the stable business keys (e.g., PayNumber).
- Define the canonical table schema:
- required columns, types, allowed values, and “unknown” handling.
- Design ingestion with Power Query:
- Prefer Folder ingest + combine, with defensive “missing column” handling.
- Normalize column names (trim, case, collapse spaces).
- Design cleansing & validation:
- Create a Data_Staging query (raw-normalized) and Data_Clean query (validated).
- Add validation columns (e.g.,
IsValidPayNumber, IsValidDate, IssueReason).
- Build reporting layer:
- Pivot table(s) off Data_Clean
- Slicers: Year, ISOWeek; plus operational dimensions
- Add a “Refresh Status” sheet:
- last refresh timestamp, row counts, query error flags, latest week present
- STOP AND ASK THE USER if:
- required KPIs/columns are unspecified,
- the source files don’t include any stable key,
- week definition/timezone rules are unclear,
- PDF/DOCX tables are not reliably extractable without a provided export.
OUTPUT FORMAT
When producing a plan, use this template:
WORKBOOK PLAN
- Sheets:
- Data_Staging (query output)
- Data_Clean (query output + validation flags)
- Dashboard (pivots/charts)
- Refresh_Status (counts + health checks)
- Canonical Schema:
- <Column>: <Type> | Required? | Validation
- Power Query:
- Query 1: Ingest_<name> (Folder/File)
- Query 2: Clean_<name>
- Key transforms: <bullets>
- Validation rules:
- <rule> -> <action>
- Pivot design:
- Rows/Columns/Values
- Slicers
If asked for artifacts, also output:
assets/power-query-folder-ingest-template.pq (adapted)
assets/refresh-checklist.md
SAFETY & EDGE CASES
- Read-only by default: provide a plan + snippets unless the user explicitly requests file generation.
- Never delete or overwrite user files; propose new filenames for outputs.
- Prefer “no silent failure”: include row-count checks and visible error flags.
- For PDF/DOCX sources, require user-provided exported tables (CSV/XLSX) or clearly mark extraction risk.
EXAMPLES
Input: “Folder of weekly CSVs with PayNumber/Name/Date.”
Output: Folder-ingest PQ template + schema + Refresh Status checks + pivot dashboard plan.
Input: “Refresh breaks when new columns appear.”
Output: Defensive missing-column logic + column normalization + typed schema plan.
1---2name: excel-weekly-dashboard3description: Designs refreshable Excel dashboards (Power Query + structured tables + validation + pivot reporting). Use when you need a repeatable weekly KPI workbook that updates from files with minimal manual work.4---5
6# Excel weekly dashboards at scale
7
8## PURPOSE
9Designs refreshable Excel dashboards (Power Query + structured tables + validation + pivot reporting).
10
11## WHEN TO USE
12- TRIGGERS:
13 - Build me a Power Query pipeline for this file so it refreshes weekly with no manual steps.
14 - Turn this into a structured table with validation lists and clean data entry rules.
15 - Create a pivot-driven weekly dashboard with slicers for year and ISO week.
16 - Fix this Excel model so refresh does not break when new columns appear.
17 - Design a reusable KPI pack that updates from a folder of CSVs.
18- DO NOT USE WHEN…
19 - You need advanced forecasting/valuation modeling (this skill is for repeatable reporting pipelines).
20 - You need a BI tool build (Power BI/Tableau) rather than Excel.
21 - You need web scraping as the primary ingestion method.
22
23## INPUTS
24- REQUIRED:
25 - Source data file(s): CSV, XLSX, DOCX-exported tables, or PDF-exported tables (provided by user).
26 - Definition of ‘week’ (ISO week preferred) and the KPI fields required.
27- OPTIONAL:
28 - Data dictionary / column definitions.
29 - Known “bad data” patterns to validate (e.g., blank PayNumber, invalid dates).
30 - Existing workbook to refactor.
31- EXAMPLES:
32 - Folder of weekly CSV exports: `exports/2026-W02/*.csv`
33 - Single XLSX dump with changing columns month to month
34
35## OUTPUTS
36- If asked for **plan only (default)**: a step-by-step build plan + Power Query steps + sheet layout + validation rules.
37- If explicitly asked to **generate artifacts**:
38 - `workbook_spec.md` (workbook structure and named tables)
39 - `power_query_steps.pq` (M code template)
40 - `refresh-checklist.md` (from `assets/`)
41Success = refresh works after adding a new week’s files without manual edits, and validation catches bad rows.
42
43
44## WORKFLOW
451. Identify source type(s) (CSV/XLSX/DOCX/PDF-export) and the stable business keys (e.g., PayNumber).
462. Define the canonical table schema:
47 - required columns, types, allowed values, and “unknown” handling.
483. Design ingestion with Power Query:
49 - Prefer **Folder ingest** + combine, with defensive “missing column” handling.
50 - Normalize column names (trim, case, collapse spaces).
514. Design cleansing & validation:
52 - Create a **Data_Staging** query (raw-normalized) and **Data_Clean** query (validated).
53 - Add validation columns (e.g., `IsValidPayNumber`, `IsValidDate`, `IssueReason`).
545. Build reporting layer:
55 - Pivot table(s) off **Data_Clean**
56 - Slicers: Year, ISOWeek; plus operational dimensions
576. Add a “Refresh Status” sheet:
58 - last refresh timestamp, row counts, query error flags, latest week present
597. STOP AND ASK THE USER if:
60 - required KPIs/columns are unspecified,
61 - the source files don’t include any stable key,
62 - week definition/timezone rules are unclear,
63 - PDF/DOCX tables are not reliably extractable without a provided export.
64
65
66## OUTPUT FORMAT
67When producing a **plan**, use this template:
68
69```text
70WORKBOOK PLAN
71- Sheets:
72 - Data_Staging (query output)
73 - Data_Clean (query output + validation flags)
74 - Dashboard (pivots/charts)
75 - Refresh_Status (counts + health checks)
76- Canonical Schema:
77 - <Column>: <Type> | Required? | Validation
78- Power Query:
79 - Query 1: Ingest_<name> (Folder/File)
80 - Query 2: Clean_<name>
81 - Key transforms: <bullets>
82- Validation rules:
83 - <rule> -> <action>
84- Pivot design:
85 - Rows/Columns/Values
86 - Slicers
87```
88
89If asked for artifacts, also output:
90- `assets/power-query-folder-ingest-template.pq` (adapted)
91- `assets/refresh-checklist.md`
92
93
94## SAFETY & EDGE CASES
95- Read-only by default: provide a plan + snippets unless the user explicitly requests file generation.
96- Never delete or overwrite user files; propose new filenames for outputs.
97- Prefer “no silent failure”: include row-count checks and visible error flags.
98- For PDF/DOCX sources, require user-provided exported tables (CSV/XLSX) or clearly mark extraction risk.
99
100
101## EXAMPLES
102- Input: “Folder of weekly CSVs with PayNumber/Name/Date.”
103 Output: Folder-ingest PQ template + schema + Refresh Status checks + pivot dashboard plan.
104
105- Input: “Refresh breaks when new columns appear.”
106 Output: Defensive missing-column logic + column normalization + typed schema plan.
107