business-intelligence
Builds reporting and self-serve analytics that people actually use — metric trees, dashboard design, distribution, and the discipline that stops dashboards proliferating. Use this to build a dashboard or report, design a metrics framework, set up self-serve analytics, decide what
Install
npx skills add https://github.com/cbrock84/headcount/tree/main/plugins/data-analytics/skills/business-intelligence
claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install cbrock84-headcount@llmmart
git clone https://github.com/cbrock84/headcount.git
The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole cbrock84/headcount collection as a plugin from our marketplace. Git is the plain clone.
Skill manifest
Business intelligence
Most organizations have too many dashboards and too little insight. The two are related: when everything is measured, nothing is watched.
Start from the decision
Every report answers one question for one audience who can act on it. Before building, name the decision it informs and what a viewer would do differently based on it.
If nothing would change, do not build it. That single filter removes most dashboard requests, and the ones surviving it get used.
Metric trees
Structure metrics as a tree, not a list. One primary outcome at the top, decomposed into the drivers that mathematically produce it, each decomposed again.
Revenue = customers × average value. Customers = new + retained. New = traffic × conversion. And so on.
This does two things a metric list cannot: when the top number moves, you can walk down to find where; and it makes clear which metrics are levers and which are outcomes. Teams should be measured on levers they control, not on outcomes they influence.
Dashboard design
- One screen, one question. Scrolling dashboards are several dashboards that were not separated.
- Lead with the answer — the primary number, its comparison, and whether that is good. A number with no comparison is not information.
- Comparison always: prior period, target, or cohort. Choose deliberately, because each tells a different story.
- Say what "good" is. A viewer who cannot tell whether 4.2% is good will not act.
- Annotate the anomalies. The spike everyone asks about should carry its explanation, or you will explain it every month.
- Cut the rest. Charts nobody uses cost attention on every visit and make the useful ones harder to find.
Self-serve
Self-serve works when the semantic layer is trustworthy and the questions are anticipated. It fails when people are handed raw tables and left to define metrics themselves — that produces confident wrong answers, which is worse than a queue.
Give governed metrics, curated datasets, and templates for common questions. Keep the raw layer for analysts.
Trust
Reporting nobody trusts is not used, and trust is lost far faster than it is rebuilt. Protect it by showing freshness on every dashboard, surfacing failures rather than serving stale data silently, and reconciling against the system of record for anything financial.
When a number is wrong, say so prominently and fast. Quietly correcting it is how a team learns to check every figure by hand.
Maintenance
Dashboards accumulate. Review usage periodically and retire what nobody opens — with a notice period, since the one person using it may be using it for something important.
Sources
references/sources.md in this skill lists the outside authorities that settle the questions
here — what each one is authoritative for, and what you may do with it. Check them before
answering on anything they cover, and cite what you used. Most are free to read and not free
to reproduce; the use note on each is binding.
Tooling
BI: Power BI, Looker, Tableau, Metabase, Omni, Hex, and similar.
Metric definitions belong in a semantic layer — dbt's, Looker's LookML, Cube — rather than in each dashboard's SQL, or the same metric will disagree with itself across two tabs.
Spreadsheets remain the most-used BI tool in every organization. Plan for the export rather than pretending it will not happen.
Never
- Build a dashboard nobody has a decision for. Start from the decision.
- Ship a metric with two definitions live at the same time.
- Leave a dashboard published with no owner. Unowned dashboards get trusted, then get wrong.
- Show a number without the denominator and the window it covers.
Files (headcount)
-
references
-
sources.md 1.5 KB
# Sources — `data-analytics:business-intelligence` <!-- Generated by scripts/build-sources.py from sources/*.toml. Do not edit. --> Check these before answering on anything they cover, and cite what you used. The use note on each one is binding: most of what a professional cites is free to read and not free to reproduce. ## Commission Guidance on Management's Discussion and Analysis, Release 33-10751 US Securities and Exchange Commission · US · public domain (US government) — quote freely <https://www.federalregister.gov/documents/2020/02/25/2020-02296/commission-guidance-on-managements-discussion-and-analysis-of-financial-condition-and-results-of> **Authoritative for:** What a company must do when it publishes an operating metric — define it, disclose how it is calculated, apply it consistently, and explain any change in method. It disciplines metrics like recurring revenue and net retention without defining them, which is the honest ceiling on authority here. ## Statistical Quality Standards US Census Bureau · US · public domain (US government) — quote freely <https://www.census.gov/about/policies/quality/standards.html> **Authoritative for:** The quality requirements at each stage of producing a statistical product, including when an estimate must be suppressed or flagged rather than published. --- Sources are maintained in `sources/` upstream, not here. If one is wrong, out of date, or missing, fix it there — this file is regenerated and an edit to it is lost.
-
-
SKILL.md 4.1 KB
--- name: business-intelligence description: Builds reporting and self-serve analytics that people actually use — metric trees, dashboard design, distribution, and the discipline that stops dashboards proliferating. Use this to build a dashboard or report, design a metrics framework, set up self-serve analytics, decide what to measure, or diagnose why reporting exists but nobody uses it or trusts it. --- # Business intelligence Most organizations have too many dashboards and too little insight. The two are related: when everything is measured, nothing is watched. ## Start from the decision Every report answers one question for one audience who can act on it. Before building, name the decision it informs and what a viewer would do differently based on it. If nothing would change, do not build it. That single filter removes most dashboard requests, and the ones surviving it get used. ## Metric trees Structure metrics as a tree, not a list. One primary outcome at the top, decomposed into the drivers that mathematically produce it, each decomposed again. Revenue = customers × average value. Customers = new + retained. New = traffic × conversion. And so on. This does two things a metric list cannot: when the top number moves, you can walk down to find *where*; and it makes clear which metrics are levers and which are outcomes. Teams should be measured on levers they control, not on outcomes they influence. ## Dashboard design - **One screen, one question.** Scrolling dashboards are several dashboards that were not separated. - **Lead with the answer** — the primary number, its comparison, and whether that is good. A number with no comparison is not information. - **Comparison always**: prior period, target, or cohort. Choose deliberately, because each tells a different story. - **Say what "good" is.** A viewer who cannot tell whether 4.2% is good will not act. - **Annotate the anomalies.** The spike everyone asks about should carry its explanation, or you will explain it every month. - **Cut the rest.** Charts nobody uses cost attention on every visit and make the useful ones harder to find. ## Self-serve Self-serve works when the semantic layer is trustworthy and the questions are anticipated. It fails when people are handed raw tables and left to define metrics themselves — that produces confident wrong answers, which is worse than a queue. Give governed metrics, curated datasets, and templates for common questions. Keep the raw layer for analysts. ## Trust Reporting nobody trusts is not used, and trust is lost far faster than it is rebuilt. Protect it by showing freshness on every dashboard, surfacing failures rather than serving stale data silently, and reconciling against the system of record for anything financial. When a number is wrong, say so prominently and fast. Quietly correcting it is how a team learns to check every figure by hand. ## Maintenance Dashboards accumulate. Review usage periodically and retire what nobody opens — with a notice period, since the one person using it may be using it for something important. ## Sources `references/sources.md` in this skill lists the outside authorities that settle the questions here — what each one is authoritative for, and what you may do with it. Check them before answering on anything they cover, and cite what you used. Most are free to read and not free to reproduce; the use note on each is binding. ## Tooling BI: Power BI, Looker, Tableau, Metabase, Omni, Hex, and similar. Metric definitions belong in a semantic layer — dbt's, Looker's LookML, Cube — rather than in each dashboard's SQL, or the same metric will disagree with itself across two tabs. Spreadsheets remain the most-used BI tool in every organization. Plan for the export rather than pretending it will not happen. ## Never - Build a dashboard nobody has a decision for. Start from the decision. - Ship a metric with two definitions live at the same time. - Leave a dashboard published with no owner. Unowned dashboards get trusted, then get wrong. - Show a number without the denominator and the window it covers.
Comments (0)
Sign in to join the conversation.
Reviews (0)
No reviews yet.
No comments yet.