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
npx skills add OneWave-AI/claude-skills --skill weekly-business-report -a claude-codeWhat 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-code2Manually: put the files in place
~/.claude/skills/weekly-business-report/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/weekly-business-report/
1Skills CLI (Vercel)
npx skills add OneWave-AI/claude-skills --skill weekly-business-report -a codex2Manually: put the files in place
.agents/skills/weekly-business-report/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add OneWave-AI/claude-skills --skill weekly-business-report -a cursor2Manually: put the files in place
.cursor/skills/weekly-business-report/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install OneWave-AI/claude-skills weekly-business-report2Manually: put the files in place
.github/skills/weekly-business-report/SKILL.md1Skills CLI (Vercel)
npx skills add OneWave-AI/claude-skills --skill weekly-business-report -a gemini-cli2Platform CLI
gemini skills install https://github.com/OneWave-AI/claude-skills --path weekly-business-reportManually: put the files in place
.devin/skills/weekly-business-report/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add OneWave-AI/claude-skills --skill weekly-business-report -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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