Afrexai Kpi Tracker

# KPI Tracker Skill

Track, analyze, and report on Key Performance Indicators for any business.

## What It Does

When activated, this skill helps you:
- Define and categorize KPIs (revenue, ops, marketing, customer success)
- Set targets and thresholds (green/yellow/red)
- Generate weekly/monthly KPI reports in markdown
- Flag KPIs that are off-track with root cause prompts
- Store historical data in a simple JSON file for trend analysis

## Usage

Tell your agent: "Track these KPIs" or "Give me a KPI report" or "Which metrics are off track?"

### Setup

Create `kpi-config.json` in your workspace:

```json
{
  "kpis": [
    {
      "name": "Monthly Recurring Revenue",
      "category": "revenue",
      "unit": "$",
      "target": 50000,
      "redBelow": 35000,
      "yellowBelow": 45000
    },
    {
      "name": "Customer Churn Rate",
      "category": "customer",
      "unit": "%",
      "target": 3,
      "redAbove": 7,
      "yellowAbove": 5
    }
  ]
}
```

### Recording Data

Say: "Record MRR at $42,000 for this week"

The agent stores entries in `kpi-data.json`:
```json
{
  "entries": [
    { "kpi": "Monthly Recurring Revenue", "value": 42000, "date": "2026-02-13", "note": "Post-launch week" }
  ]
}
```

### Reports

Say: "KPI report" and the agent generates a formatted status board:

```
📊 KPI Report — Week of Feb 10, 2026

🟢 Monthly Recurring Revenue: $48,200 (target: $50,000) — 96.4%
🔴 Customer Churn Rate: 8.1% (target: 3%) — needs attention
🟡 Lead Conversion Rate: 11% (target: 15%) — trending up from 9%

⚠️ Action needed on 1 red, 1 yellow KPI
```

### Trend Analysis

Say: "Show MRR trend" — the agent reads historical entries and summarizes direction, velocity, and whether you'll hit target at current pace.

## How the Agent Should Behave

1. Read `kpi-config.json` for KPI definitions
2. Read/write `kpi-data.json` for historical values
3. When asked for a report: calculate status for each KPI, format with color indicators
4. When a KPI is red: proa...

# 📊 KPI Tracker — OpenClaw Skill

Track key business metrics, set targets, and get status reports — all through your AI agent.

## Why

Most KPI tools are overbuilt dashboards you stop checking after a week. This skill turns your agent into a lightweight metrics tracker that actually tells you when something's off.

No SaaS subscription. No dashboard login. Just ask your agent "how are we doing?" and get a straight answer.

## What You Get

- **Define KPIs** with targets and red/yellow/green thresholds
- **Record values** conversationally ("MRR hit $48K this week")
- **Status reports** with color-coded health indicators
- **Trend analysis** — are you on track to hit target at current pace?
- **Proactive alerts** — agent flags red KPIs before you ask

## Quick Start

1. Install: `clawhub install afrexai-kpi-tracker`
2. Create `kpi-config.json` with your metrics (see SKILL.md for format)
3. Tell your agent: "Record [metric] at [value]"
4. Ask: "KPI report" any time

## Example Report

```
📊 KPI Report — Week of Feb 10

🟢 MRR: $48,200 / $50,000 (96.4%)
🔴 Churn: 8.1% / 3.0% — needs attention
🟡 Lead Conversion: 11% / 15% — trending up
```

## Works Great With

- **Cron jobs** — automated weekly reports every Monday morning
- **Slack/Telegram** — get KPI summaries delivered to your channel
- **[AfrexAI Context Packs](https://afrexai-cto.github.io/context-packs/)** — pre-built KPI frameworks for Fintech, Healthcare, SaaS, Legal, and 7 more industries. Drop-in configs with industry-specific metrics already defined.

## Built by AfrexAI 🖤💛

We build AI agent tools that actually work. Check out our free tools:
- [AI Revenue Calculator](https://afrexai-cto.github.io/ai-revenue-calculator/) — see if AI agents make financial sense for your business
- [Agent Setup Wizard](https://afrexai-cto.github.io/agent-setup/) — get configured in 5 minutes
- [Context Packs Store](https://afrexai-cto.github.io/context-packs/) — industry-specific AI agent configs

License: MIT