Skip to content
cccskills
FreePublished on GitHub

codexkit-dashboard-kpi-designer

Design KPI dashboards with SMART metrics, visualization selection, alert thresholds, and refresh cadence. Covers leading vs lagging indicators, data dictionary, and stakeholder-specific views. Use when building operational dashboards, executive scorecards, or team performance views.

The English summary is being prepared. Showing the original description.

See how to install

Files included (5)

  • SKILL.md5.4 KB
  • agents/openai.yaml179 B
  • examples/common-mistakes.md688 B
  • examples/good-output.md839 B
  • verification/checklist.md1.4 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Dashboard & KPI Designer

When to Use

  • When building a new operational or executive dashboard
  • When KPIs exist but lack clear targets, thresholds, or visualization
  • When stakeholders ask "what should we measure?"
  • When consolidating scattered metrics into a single source of truth

Procedure

Step 1 — Objectives Alignment

Clarify what decisions the dashboard must support:

  • Who is the primary audience? (executive, manager, analyst, operator)
  • What decisions do they make with this data?
  • What cadence? (real-time, daily, weekly, monthly)

Step 2 — KPI Selection

For each objective, define KPIs using the SMART-KPI framework:

KPITypeTargetThreshold (Green/Amber/Red)Data Source
[name]Leading / Lagging[value]G: ≥X / A: Y–X / R: <Y[source]

Rules:

  • Max 7 KPIs per dashboard view
  • Every lagging indicator must have ≥1 leading indicator
  • Every KPI must have a named owner

Step 3 — Visualization Selection

Data PatternRecommended ChartAvoid
Trend over timeLine chartPie chart
Part-to-wholeStacked bar, treemap3D charts
ComparisonBar chart, bullet chartRadar chart (>7 axes)
Single value vs targetGauge, big number + trend arrowTable
DistributionHistogram, box plotLine chart
RelationshipScatter plotStacked area

Step 4 — Layout & Hierarchy

Build the dashboard with visual hierarchy:

  1. Top row: 3–5 big-number tiles (most critical KPIs with trend arrows)
  2. Middle: 2–3 trend charts showing performance over time
  3. Bottom: Detail tables or drill-down areas
  4. Use consistent color: Green/Amber/Red for status, brand colors for categories

Step 5 — Data Dictionary

For each KPI, document:

  • Definition: exactly how it's calculated
  • Numerator / Denominator: if it's a ratio
  • Inclusions / Exclusions: what counts and what doesn't
  • Refresh frequency: real-time, hourly, daily, weekly
  • Owner: who is accountable for this metric

Step 6 — Alert Rules

KPIConditionSeverityAction
[name]Value < threshold for 2 consecutive periodsWarningNotify owner via Slack/email
[name]Value < critical thresholdCriticalEscalate to leadership

Inputs

InputRequiredFormat
Business objectivesYesWhat decisions does this dashboard support?
AudienceYesWho will view this dashboard?
Available data sourcesYesList of systems/databases
Existing metricsRecommendedCurrent KPIs if any
Refresh requirementRecommendedReal-time / daily / weekly

Output

## Dashboard Design — [Dashboard Name]

### Audience & Purpose
**Primary user:** Regional Sales Managers
**Decision supported:** Territory resource allocation
**Refresh:** Daily at 6 AM

### KPIs

| KPI | Type | Target | Green | Amber | Red | Owner |
|-----|------|--------|-------|-------|-----|-------|
| Monthly Revenue | Lagging | $1.2M | ≥100% | 85–99% | <85% | VP Sales |
| Pipeline Coverage | Leading | 3.0× | ≥3× | 2–3× | <2× | Sales Ops |
| Win Rate | Lagging | 28% | ≥28% | 22–27% | <22% | VP Sales |
| Activities/Rep/Week | Leading | 50 | ≥50 | 35–49 | <35 | Team Leads |

### Layout Wireframe
Row 1: [Revenue] [Pipeline] [Win Rate] [Activity Score]
Row 2: [Revenue Trend — 12 months] [Pipeline by Stage — stacked bar]
Row 3: [Rep Performance Table — sortable] [Territory Map — if applicable]

### Data Dictionary
[One entry per KPI with formula, source, refresh]

### Alert Rules
[Threshold-based notifications per KPI]

Definition of Done

  • Max 7 KPIs per view
  • Every KPI has a target, threshold, and owner
  • Leading and lagging indicators balanced
  • Visualization type justified for each data pattern
  • Data dictionary complete
  • Alert rules defined

Quality Criteria

  • Data sources and assumptions are explicitly stated
  • Calculations are reproducible from provided inputs
  • Visualizations or tables have clear labels, units, and time ranges
  • Caveats and confidence levels are documented for estimates

Verification (4C)

CheckQuestion
CorrectnessAre formulas, aggregations, and statistical methods applied correctly?
CompletenessDoes the analysis cover all requested metrics and time ranges?
Context-fitAre the chosen metrics relevant to the business question being answered?
ConsequenceIf this data were used for a decision today, what blind spots remain?

Edge Cases

  • Missing or incomplete data — Document gaps and their potential impact on conclusions. Provide ranges instead of point estimates.
  • Outliers skewing results — Report with and without outliers. Document the decision to include or exclude.
  • Changing data definitions mid-period — Split analysis at the change boundary and note the schema difference.

Changelog

  • v1.0.0 — Initial release

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Design rigorous A/B test plans with hypothesis, sample size calculation, Minimum Detectable Effect (MDE), randomization strategy, and decision rules. Includes guardrail metrics and rollout playbook. Use when planning product experiments, conversion optimization, or data-driven feature decisions.

The English summary is being prepared. Showing the original description.

hoavdc/CodexKit25Updated Oct 11, 2026

Review REST and GraphQL API designs for consistency, usability, and best practices. Covers naming conventions, versioning strategy, error format, pagination, authentication patterns, and breaking change detection. Use when reviewing API specs, designing new APIs, or auditing existing endpoints.

The English summary is being prepared. Showing the original description.

hoavdc/CodexKit25Updated Oct 11, 2026

Write Architecture Decision Records (ADRs) following the Michael Nygard format. Captures context, options considered, decision rationale, and consequences. Use when making technology choices, framework selections, or any architectural decision that future developers need to understand.

The English summary is being prepared. Showing the original description.

hoavdc/CodexKit25Updated Oct 11, 2026

Assess organizational readiness for financial audits (internal or external). Map assertions to account balances, check evidence completeness, score readiness using a Red/Amber/Green framework, and generate a remediation timeline. Aligned with SOX, IFRS, and GAAP audit standards. Use before scheduled audits or when preparing for first-time compliance.

The English summary is being prepared. Showing the original description.

hoavdc/CodexKit25Updated Oct 11, 2026

Design safe recurring Codex automations with clear prompts, outputs, schedules, and gating rules.

The English summary is being prepared. Showing the original description.

hoavdc/CodexKit25Updated Oct 11, 2026

Refine Product Backlog Items to meet INVEST criteria. Write User Stories with Acceptance Criteria in Given/When/Then format, estimate with Story Points, and flag dependencies. Use before sprint planning when backlog items need grooming. Do not use to prioritize the backlog — that is the Product Owner's decision.

The English summary is being prepared. Showing the original description.

hoavdc/CodexKit25Updated Oct 11, 2026

See all skills by hoavdc

Report a problem with this skill