ce-product-pulse

Generate time-windowed product pulse reports covering usage, performance, errors, and followups.

Updated Mar 17, 2026
One-click install
npx skills add https://github.com/Norfolk-Group/marcela-norfolk-ai --skill ce-product-pulse-norfolk-group
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ce-product-pulse
Source: https://github.com/Norfolk-Group/marcela-norfolk-ai/tree/main/skills/compound-engineering/skills/ce-product-pulse
Command: npx skills add https://github.com/Norfolk-Group/marcela-norfolk-ai --skill ce-product-pulse-norfolk-group

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Product teams lack a fast, consolidated view of how users experienced the product over a recent window, forcing them to jump between analytics, tracing, and payments dashboards to answer "how are we doing." ## Core Features & Use Cases - Time-Windowed Pulse Reports: Query analytics, tracing, payments, and optional read-only database sources over windows like 24h or 7d and assemble a single-page report saved to docs/pulse-reports/. - Guided First-Run Interview: Configure product name, engagement and value events, conversions, quality scoring, and data sources through a structured interview that pushes back on vague or vanity metrics. - AI Quality Sampling: Optionally sample up to 10 sessions per run and score them 1-5 on a user-defined quality dimension, with no PII persisted. - Use Case: After a launch, run a 1h pulse to see engagement counts, latency percentiles, top errors, and followups worth investigating, all in one saved markdown report. ## Quick Start Ask the agent to run a product pulse for the last 24 hours and save the report.

Frequently Asked Questions about ce-product-pulse

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

FAQPage Schema
How do I generate a product pulse report for the last 24 hours?

Invoke the skill with a lookback argument such as 24h, 7d, or 1h. It queries your configured analytics, tracing, and payments sources in parallel, then assembles a single-page report saved to docs/pulse-reports/ with headlines surfaced in chat.

What data sources does a product pulse report support?

The pulse supports product analytics tools like PostHog or Mixpanel, tracing tools like Sentry or Datadog, payments providers like Stripe, and an optional read-only database. Sources are configured during the first-run interview and stored as pulse_* keys in .compound-engineering/config.local.yaml.

Can I use a production database with write access as a pulse data source?

No. The interview explicitly refuses read-write database credentials and only accepts read-only replicas or read-only users. Database access is entirely optional, and many products complete the pulse using analytics and tracing alone.

Does the pulse report include user emails or message content?

No. Saved reports never contain PII such as user emails, account IDs, or message content. Quality scoring captures only a count distribution and anonymized notes for sessions scored below 4.

Why does the pulse apply a 15-minute trailing buffer to the time window?

Analytics and tracing tools have ingestion lag, so querying right up to the current moment under-reports recent events. The buffer shifts the window's upper bound back 15 minutes so the most recent data is accurate.

What are the limitations of a pulse report compared to dashboards?

The pulse does not set thresholds, send alerts, or report what shipped; it presents numbers for the reader to interpret. It consolidates a single-page read and does not replace deep investigation in native analytics or tracing dashboards.