mcpField
W
weekly-business-report

weekly-business-report

github.com/onewave-aiData & databases393258 installsUpdated 1w ago
Repository

About weekly-business-report

weekly-business-report is a skill that collects data from business systems and produces weekly reports for teams and executives tracking KPIs. It combines trends, target comparisons, rolling averages, and anomaly detection, and adjusts report detail for each recipient.

Key features

  1. 01Collects enabled data sources and saves snapshots
  2. 02Calculates KPI trends, target comparisons, and rolling averages
  3. 03Detects anomalies and compares historical data
  4. 04Supports custom KPI groups and targets
  5. 05Tailors reports to recipient detail levels
  6. 06Maintains KPI history and produces weekly reports

Use cases

  1. 01Prepare a report for the previous full business week
  2. 02Review multi-week trends for revenue or other KPIs
  3. 03Compare the last four weeks or summarize year-to-date results

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/onewave-ai/claude-skills --skill weekly-business-report

After installing, type/weekly-business-reportin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

references/
configuration.md
data-and-calculations.md
output-template.md

Details

From the project README

Weekly Business Report Generator

Pull data from multiple business systems, synthesize it into a coherent narrative, and produce an executive-ready weekly report that turns raw numbers into strategic insight.

Contents

  • references/configuration.md — first-run setup questions, directory layout, full config.yaml, and kpi-history.json schema.
  • references/data-and-calculations.md — per-source data collection, trend indicators, target comparison, rolling averages, anomaly detection, comparison modes, custom KPI groups, quality rules, and error handling.
  • references/output-template.md — the full report markdown template and detail levels.

Workflow

First run (no configuration exists)
  1. Run the setup questions and create the directory layout. See references/configuration.md.
  2. Generate config.yaml and templates/kpi-definitions.yaml from the schema in references/configuration.md.
  3. Initialize history/kpi-history.json using the schema in references/configuration.md.
Each subsequent run
  1. Read config.yaml and templates/kpi-definitions.yaml.
  2. Determine the reporting period (the previous full business week).
  3. Pull data from each enabled source and snapshot it to data/{date}/. See references/data-and-calculations.md.
  4. Calculate every KPI: trend indicators, target comparison, rolling averages, and anomalies. See references/data-and-calculations.md.
  5. Compare against targets and prior weeks; flag anomalies.
  6. Generate the report from the template in references/output-template.md, tailored to each recipient's detail level.
  7. Save the report to reports/{date}-weekly-report.md and append this week's values to history/kpi-history.json.

Quick Commands

  • "Generate this week's report" — full report for the most recent complete week.
  • "Show me revenue trends" — revenue-specific trend analysis with 4-8 week history.
  • "What are the concerns this week?" — concerns-only output.
  • "Add KPI [name]" — add a new KPI to tracking (see custom KPI groups in references/data-and-calculations.md).
  • "Update targets" — modify target values for existing KPIs.
  • "Compare last 4 weeks" — side-by-side comparison of the last 4 weekly reports.
  • "YTD summary" — year-to-date summary across all tracked KPIs.

Apply the report quality rules and error handling in references/data-and-calculations.md to every run.

Comments

Markdown supported