visualizing-change-over-time

Selects appropriate chart types for visualizing change over time in PostHog dashboards.

713|118|Updated Aug 11, 2020
One-click install
npx skills add https://github.com/PostHog/posthog-foss --skill visualizing-change-over-time
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: visualizing-change-over-time
Source: https://github.com/PostHog/posthog-foss/tree/main/.agents/skills/visualizing-change-over-time
Command: npx skills add https://github.com/PostHog/posthog-foss --skill visualizing-change-over-time

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @posthog/quill-charts.

What problem does it solve?

Choosing the wrong chart type makes change-over-time data hard to read. This Skill helps PostHog engineers and agents pick the right visualization—line charts, slope graphs, bar charts, or metric cards—when building UI with @posthog/quill-charts for dashboards, reports, and custom visualizations.

Core Features & Use Cases

  • Chart Selection Guidance: Maps the shape of the change (continuous trend, two-point before/after, magnitude comparison, single headline number) to the right quill-charts component.
  • SlopeChart Implementation: Provides a complete usage pattern for the SlopeChart component, including series shape, labels, legend, delta formatting, and label collision behavior.
  • Dual Rendering Paths: Explains when to use the SlopeChart UI component versus the ChartDisplayType.SlopeGraph insight display backed by the SlopeGraphTrendsQueryRunner, including feature flag and API/MCP tool behavior.
  • Use Case: When a user asks how signups changed week over week across regions, offer a slope graph showing each region's movement from the baseline period to the current period instead of a crowded grouped bar chart.

Quick Start

Ask the agent to visualize how a metric changed between two periods across several categories using a slope graph in a PostHog dashboard.

Frequently Asked Questions about visualizing-change-over-time

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I visualize before and after comparisons in PostHog?

Use the SlopeChart component from @posthog/quill-charts when comparing exactly two snapshots across several series. Each entity gets one line from a left before point to a right after point, making direction, magnitude, and rank flips readable at a glance.

What chart type should I use for change over time data?

Match the chart to the data shape: TimeSeriesLineChart for continuous trends over many points, SlopeChart for two-point before/after comparisons, BarChart for magnitude comparisons at points in time, and MetricCard for a single headline number with its change.

SlopeChart vs ChartDisplayType.SlopeGraph in PostHog?

SlopeChart is the @posthog/quill-charts UI component for dashboards and custom visualizations. ChartDisplayType.SlopeGraph is a first-class insight display rendered by the backend SlopeGraphTrendsQueryRunner, taking a TrendsQuery and using the first and last date buckets as the two slope points.

Can I create a slope graph insight via the PostHog API?

Yes, pass a TrendsQuery with trendsFilter.display set to SlopeGraph via the API or the posthog:insight-create MCP tool without needing the feature flag. In the product insight editor, the picker entry is gated behind the slope-graph-insight feature flag.

When should I not use a slope graph?

Avoid slope graphs for continuous series with many time points, where a line or area chart shows the slope between every pair of points. They are designed for exactly two snapshots, not for showing the path between them.