Skip to main content
skill CX Codex

weekly-business-report — Claude Code skill: reports and install

weekly-business-report is a Claude Code skill that collects weekly KPIs from enabled sources, compares them with targets and prior weeks, and saves a report. It brings business figures into a shared weekly view.

MIT 276 installs ★ 440 updated 2026-10-20

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add OneWave-AI/claude-skills --skill weekly-business-report -a claude-code
Open on GitHub

What weekly-business-report does

The skill gathers data from enabled sources, calculates trends and rolling averages, checks targets, and flags anomalies. Listed sources include Supabase analytics, CRM data, financial spreadsheets, and email metrics. It builds the report from a template, with detail adjusted for each recipient.

On its first run, it asks setup questions and creates config.yaml, templates/kpi-definitions.yaml, and history/kpi-history.json. Later runs snapshot source data under data/{date}/, write the report to reports/{date}-weekly-report.md, and append values to the history file. Without configured sources and targets, the calculations have nothing to compare against.

You can request revenue trends over 4-8 weeks, a concerns-only report, a comparison of the last 4 reports, or a YTD summary. The skill also supports adding KPIs and changing targets; its reference files describe those workflows.

What it helps with

  • combine KPIs for the previous full business week
  • compare results with targets and earlier weeks
  • flag anomalies in weekly figures
  • prepare a report at the recipient's detail level
  • add a KPI to the tracking list

Example prompts for the agent

  • Generate a report for the most recent complete business week.
  • Show revenue trends across the last 4-8 weeks.
  • Compare the last 4 weekly reports and list this week's concerns.

How to install weekly-business-report

1Skills CLI (Vercel)

npx skills add OneWave-AI/claude-skills --skill weekly-business-report -a claude-code

2Manually: put the files in place

~/.claude/skills/weekly-business-report/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/weekly-business-report/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about weekly-business-report

How do I install weekly-business-report in Claude Code?

Run npx skills add OneWave-AI/claude-skills --skill weekly-business-report -a claude-code, then open ~/.claude/skills/weekly-business-report/SKILL.md.

What does weekly-business-report do?

It gathers KPIs from enabled sources, compares them with targets and earlier periods, then saves a weekly report and KPI history.

Which platforms support weekly-business-report?

The skill is available for Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode.

Source text

SKILL.md · MIT
---
name: weekly-business-report
description: Auto-generates weekly KPI reports from multiple data sources including Supabase analytics, CRM data, financial spreadsheets, and email metrics. Produces executive-ready reports with dashboards, trends, highlights, concerns, and action items.
tools: Read, Write, Bash, Glob, Grep, WebSearch
model: inherit
---

# 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.

© OneWave-AI · MIT · OneWave-AI/claude-skills

Similar skills

All skills for Finance and business →

From the same set185

The whole set →
tech-due-diligence tech-due-diligence scans the code of a company you plan to buy or fund and writes tech-dd-report.md, with risk ratings and a go/no-go verdict. CX Codex +1 294installs workflow-automator The workflow-automator skill turns a description of a manual business process into an automation plan. It produces a Markdown document with diagrams, tool suggestions, and implementation steps. CX Codex +1 285installs sow-generator sow-generator turns a project brief into a Statement of Work with scope, deliverables, milestones, and payment terms. Use it to prepare a consulting engagement document. CX Codex +1 284installs brand-voice-analyzer brand-voice-analyzer extracts tone, vocabulary, and structure from company copy to build a style guide and audit drafts against it. CX Codex +1 281installs client-health-dashboard client-health-dashboard builds a client health view from CRM and engagement data, then produces a risk-ranked report with scores, trends, and next actions. CX Codex +1 276installs hiring-scorecard Builds a structured hiring scorecard for any role with weighted competencies, interview questions, evaluation matrix, red/green flags, and reference check questions. CX Codex +1 268installs sub-agent-orchestrator sub-agent-orchestrator chains different agents so each step feeds the next, with the flow defined in YAML. Handles retries, timeouts and parallel branches. CX Codex +1 267installs database-migrator database-migrator moves schemas, data, and database logic across PostgreSQL, MySQL, Supabase, PlanetScale, and MongoDB. Useful when a migration needs checks and a rollback plan. CX Codex +1 267installs

More in the catalog

Project sponsors

Companies that keep this analytics open