Master Business Intelligence fundamentals including KPI design, metrics frameworks, data literacy, and analytical thinking
Design SMART KPIs and metrics frameworks using Balanced Scorecard and OKR structures. Use when creating business dashboards, defining success metrics, or evaluating data-driven decisions.
/plugin marketplace add pluginagentmarketplace/custom-plugin-bi-analyst/plugin install developer-roadmap@pluginagentmarketplace-bi-analystThis skill inherits all available tools. When active, it can use any tool Claude has access to.
assets/config.yamlassets/schema.jsonreferences/GUIDE.mdreferences/PATTERNS.mdscripts/validate.pyMaster the core concepts of Business Intelligence including KPI design, metrics frameworks, data literacy, and analytical decision-making.
1. Understand what makes a good KPI (SMART criteria)
2. Learn the difference between metrics and KPIs
3. Explore common BI frameworks (Balanced Scorecard, OKRs)
4. Apply data-driven decision making
Business Intelligence (BI) transforms raw data into actionable insights for better decision-making.
DATA → INFORMATION → INSIGHT → ACTION → VALUE
↑ ↑ ↑ ↑
| | | └─ Business outcome
| | └─ Understanding "so what?"
| └─ Context + meaning
└─ Raw facts/numbers
| Aspect | Metric | KPI |
|---|---|---|
| Purpose | Measure activity | Measure success |
| Scope | Operational | Strategic |
| Target | Optional | Required |
| Audience | Teams | Leadership |
| Example | Page views | Conversion rate |
S - Specific : Clear and unambiguous
M - Measurable : Quantifiable with data
A - Achievable : Realistic given resources
R - Relevant : Aligned with business goals
T - Time-bound : Has a deadline or frequency
Example Application:
Bad: "Improve customer satisfaction"
Good: "Increase NPS score from 45 to 55 by Q4 2025"
S: NPS score (specific metric)
M: 45 → 55 (quantifiable)
A: 10-point increase (realistic)
R: Customer satisfaction (business goal)
T: By Q4 2025 (deadline)
kpi:
name: "Customer Acquisition Cost (CAC)"
category: "Growth"
owner: "Marketing Director"
formula:
numerator: "Total Sales & Marketing Spend"
denominator: "Number of New Customers Acquired"
calculation: "SUM(marketing_spend + sales_spend) / COUNT(new_customers)"
target:
value: 50
unit: "USD"
direction: "lower_is_better"
threshold_warning: 60
threshold_critical: 75
measurement:
frequency: "monthly"
data_source: "finance_db.marketing_costs, crm.customers"
lag_days: 5
context:
benchmark_industry: 45
benchmark_company_historical: 55
related_kpis: ["LTV", "LTV:CAC Ratio", "Payback Period"]
# Balanced Scorecard Framework
balanced_scorecard = {
"financial": {
"objective": "Increase shareholder value",
"kpis": [
{"name": "Revenue Growth", "target": "15% YoY"},
{"name": "Operating Margin", "target": "25%"},
{"name": "ROI", "target": "18%"}
]
},
"customer": {
"objective": "Improve customer satisfaction",
"kpis": [
{"name": "NPS", "target": ">50"},
{"name": "Customer Retention", "target": ">90%"},
{"name": "Customer Lifetime Value", "target": ">$500"}
]
},
"internal_process": {
"objective": "Optimize operations",
"kpis": [
{"name": "Cycle Time", "target": "<3 days"},
{"name": "Defect Rate", "target": "<1%"},
{"name": "On-Time Delivery", "target": ">98%"}
]
},
"learning_growth": {
"objective": "Build organizational capability",
"kpis": [
{"name": "Employee Engagement", "target": ">80%"},
{"name": "Training Hours per Employee", "target": ">40/year"},
{"name": "Internal Promotion Rate", "target": ">30%"}
]
}
}
objective: "Become the market leader in customer experience"
key_results:
- kr: "Increase NPS from 45 to 65"
progress: 0
confidence: "medium"
- kr: "Reduce average response time from 4 hours to 1 hour"
progress: 0
confidence: "high"
- kr: "Achieve 95% first-contact resolution rate"
progress: 0
confidence: "low"
initiatives:
- "Implement AI chatbot for 24/7 support"
- "Train all support staff on empathy communication"
- "Create self-service knowledge base"
❌ Vanity Metrics: Metrics that look good but don't drive action
Example: Total page views (without context)
❌ Metric Overload: Too many KPIs diluting focus
Example: 50+ KPIs on a dashboard
❌ Lagging Only: All backward-looking, no predictive indicators
Example: Only measuring revenue, not pipeline
❌ Misaligned Incentives: KPIs that encourage wrong behavior
Example: Call center measured only on calls/hour
❌ Black Box Metrics: Complex calculations no one understands
Example: "Engagement Score" with undocumented formula
ACCURACY → Data correctly reflects reality
COMPLETENESS → No missing values or records
TIMELINESS → Data is current and up-to-date
CONSISTENCY → Same data across different systems
VALIDITY → Data conforms to business rules
UNIQUENESS → No duplicate records
Growth: MRR, ARR, Net Revenue Retention
Acquisition: CAC, LTV, LTV:CAC Ratio
Engagement: DAU/MAU, Feature Adoption, Time in App
Churn: Logo Churn, Revenue Churn, Expansion Revenue
Sales: GMV, AOV, Conversion Rate
Customer: Repeat Purchase Rate, CLV, Cart Abandonment
Operations: Inventory Turnover, Order Fulfillment Time
Marketing: ROAS, Organic vs Paid Traffic %
Efficiency: OEE, Cycle Time, Throughput
Quality: Defect Rate, First Pass Yield, Scrap Rate
Delivery: On-Time Delivery, Lead Time, Fill Rate
Cost: Cost per Unit, Labor Productivity, Waste %
COMPANY LEVEL (CEO/Board)
├── Revenue Growth (+15% YoY)
├── Profitability (25% EBITDA)
└── Customer Satisfaction (NPS >50)
│
├── DIVISION LEVEL (VP)
│ ├── Sales Revenue
│ ├── Marketing Efficiency (CAC)
│ └── Product Adoption Rate
│ │
│ └── TEAM LEVEL (Manager)
│ ├── Leads Generated
│ ├── Conversion Rate
│ ├── Feature Usage
│ └── Support Tickets
│ │
│ └── INDIVIDUAL LEVEL
│ ├── Calls Made
│ ├── Deals Closed
│ └── Tasks Completed
const executeWithRetry = async (operation: () => Promise<any>) => {
const retryConfig = {
maxRetries: 3,
backoffMs: [1000, 2000, 4000],
retryableErrors: ['TIMEOUT', 'NETWORK_ERROR', 'RATE_LIMITED']
};
for (let attempt = 0; attempt <= retryConfig.maxRetries; attempt++) {
try {
return await operation();
} catch (error) {
if (attempt === retryConfig.maxRetries) throw error;
if (!retryConfig.retryableErrors.includes(error.code)) throw error;
await sleep(retryConfig.backoffMs[attempt]);
}
}
};
const skillHooks = {
onSkillStart: (params) => {
console.log(`[BI-FUNDAMENTALS] Starting: ${params.topic}`);
metrics.increment('skill.bi_fundamentals.started');
},
onSkillComplete: (result) => {
console.log(`[BI-FUNDAMENTALS] Completed successfully`);
metrics.increment('skill.bi_fundamentals.completed');
},
onSkillError: (error) => {
console.error(`[BI-FUNDAMENTALS] Error: ${error.message}`);
metrics.increment('skill.bi_fundamentals.errors');
}
};
describe('BI Fundamentals Skill', () => {
describe('KPI Design', () => {
it('should validate SMART criteria', () => {
const kpi = {
name: 'Customer Retention Rate',
target: '90%',
frequency: 'monthly',
owner: 'Customer Success Manager'
};
expect(validateSMART(kpi)).toBe(true);
});
it('should reject vague KPIs', () => {
const kpi = { name: 'Improve things' };
expect(validateSMART(kpi)).toBe(false);
});
});
describe('Metrics Framework', () => {
it('should balance leading and lagging indicators', () => {
const framework = buildBalancedScorecard(input);
expect(framework.leadingIndicators.length).toBeGreaterThan(0);
expect(framework.laggingIndicators.length).toBeGreaterThan(0);
});
});
});
| Issue | Cause | Solution |
|---|---|---|
| KPI not moving | Wrong metric selected | Review leading vs lagging |
| Data not available | Missing data source | Map data requirements first |
| Stakeholder confusion | Complex formula | Simplify and document |
| Gaming the metric | Misaligned incentive | Add balancing metrics |
| Version | Date | Changes |
|---|---|---|
| 1.0.0 | 2024-01 | Initial release |
| 2.0.0 | 2025-01 | Production-grade with schemas |
Use when working with Payload CMS projects (payload.config.ts, collections, fields, hooks, access control, Payload API). Use when debugging validation errors, security issues, relationship queries, transactions, or hook behavior.
Creating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems. Create original algorithmic art rather than copying existing artists' work to avoid copyright violations.