cja-executive-briefing

Generates print-ready HTML executive performance briefings from Customer Journey Analytics data.

1|Updated Jun 22, 2026
One-click install
npx skills add https://github.com/aemgdc/aemdev --skill cja-executive-briefing-aemgdc
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: cja-executive-briefing
Source: https://github.com/aemgdc/aemdev/tree/main/.agents/skills/cja-executive-briefing
Command: npx skills add https://github.com/aemgdc/aemdev --skill cja-executive-briefing-aemgdc

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning raw Customer Journey Analytics metrics into a leadership-ready summary is slow and error-prone: analysts must pick the right KPIs, compute comparable date ranges, find what drove changes, and format everything for executives who will not read data tables. This Skill automates that entire pipeline and produces a polished HTML briefing readable in under three minutes. ## Core Features & Use Cases - Deterministic KPI selection and date alignment: Selects the top 6 metrics by usage count and computes current vs comparison periods (weekly, MTD, monthly, QTD, quarterly, custom) using the data view's calendar conventions, so repeated runs produce identical results. - Driver analysis: Breaks down the two most-moved KPIs by dimensions like marketing channel to explain what caused the change in plain business language. - Print-ready HTML output: Renders KPI tiles, an executive narrative, collapsible detail tables, and an auditable methodology footer into a styled HTML document. - Use Case: Ask for a "weekly business review" and receive an HTML briefing with revenue, orders, and conversion KPI tiles, narrative bullets naming the driving channel, and a footer disclosing the exact metric IDs and date ranges used. ## Quick Start Ask the assistant to generate an executive briefing of last week's performance using your CJA data view.

Frequently Asked Questions about cja-executive-briefing

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

FAQPage Schema
How do I create an executive summary from Customer Journey Analytics data?▼

Ask for an executive briefing, performance summary, or business review and specify the period. The skill selects top KPIs by usage, pulls current and prior period data via runReport, identifies drivers, and writes a styled HTML briefing to /tmp.

What reporting periods does the CJA executive briefing support?▼

It supports weekly, month-to-date, monthly, quarter-to-date, quarterly, and custom date ranges. Date alignment uses the data view's calendar conventions such as week start day and fiscal year start month, with six invariants verified before any report runs.

How are the KPIs in the briefing selected?▼

KPIs come from listComponentUsage for metrics and calculated metrics, sorted by usage count descending with ties broken alphabetically by metric ID. The top 6 form the KPI set, and the resolved metric IDs are disclosed in the briefing footer for auditability.

Does the briefing handle missing or null metric data?▼

Yes. If both periods return no data, the tile renders as Data unavailable with a warning pill and stays in the grid. If only one period has data, the valid value is shown with a note. The skill never substitutes a different metric to hide gaps.

Can the briefing be tailored for a board or external audience?▼

Yes. Stating the audience is board, external, or investors shifts the narrative to high-level business outcomes, removes internal channel naming, and leads with the most positive finding. The default audience is internal leadership.

Why do repeated briefing runs produce the same numbers?▼

Determinism comes from reading calendar conventions from the data view context guide and applying fixed alignment rules per period type, plus selecting metrics by a stable usage-count sort. Two runs on the same data view and period produce identical date ranges and metric IDs.