# cja-dimension-analysis

cja-dimension-analysis — a skill for Claude Code, Cursor, Copilot and other platforms that builds a report on Adobe Customer Journey Analytics dimensions — cardinality, skew, anomalies, data quality, forecasts.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 375 installs · ★ 335 repo stars
- Author: Adobe
- License: Apache-2.0 · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/adobe/skills/tree/HEAD/plugins/adobe-cja/skills/cja-dimension-analysis/SKILL.md
- Updated: 2026-10-24
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/cja-dimension-analysis

## What it does

Works with the CJA MCP server and runs seven phases: cardinality (counting unique values), distribution and skew (top-1, top-5 share, Gini coefficient), trends (growth, decline, new values), anomalies by z-score, data quality checks (empty values, `null`, `Unspecified`), dimension or period comparisons, and linear forecasting for top values. Output is an HTML dashboard or markdown report.

The skill requires a configured CJA MCP server and access to a data view. At start, it asks which dimensions to analyze, which phases to run (you can pick a subset, like "just cardinality and errors"), date range, and metric for distribution. Analyzing all dimensions in a data view is slow — the skill warns and offers to limit to the top 50.

Returns: cardinality level (LOW / MEDIUM / HIGH / VERY HIGH), trend badges (🟢 growth, 🔴 decline, 🆕 new value), anomaly list with dates and magnitude, missing data percentage, and seven-period forecast for values with enough data.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add adobe/skills --skill cja-dimension-analysis -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/cja-dimension-analysis/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/cja-dimension-analysis/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add adobe/skills --skill cja-dimension-analysis -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/cja-dimension-analysis/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add adobe/skills --skill cja-dimension-analysis -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/cja-dimension-analysis/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install adobe/skills plugins/adobe-cja/skills/cja-dimension-analysis
```

2. **Manually: put the files in place**
- File: `.github/skills/cja-dimension-analysis/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add adobe/skills --skill cja-dimension-analysis -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/adobe/skills --path plugins/adobe-cja/skills/cja-dimension-analysis
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/cja-dimension-analysis/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add adobe/skills --skill cja-dimension-analysis -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/adobe/skills/tree/HEAD/plugins/adobe-cja/skills/cja-dimension-analysis/SKILL.md

## When to use it
- check data quality in CJA dimensions and find empty values
- compare distribution and trends of two dimensions across periods
- find anomalies and spikes in dimension values
- forecast top dimension values for the next week
- see which dimension values grew or disappeared over a period

## Example prompts
- Check the health of Page Name dimension for the last 90 days
- Show top 10 Browser Type values and their share
- Compare cardinality and skew of Campaign ID and Tracking Code dimensions for the last month

## Source text · SKILL.md · Apache-2.0

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: cd9bee76d6e44f39.

BEGIN THIRD-PARTY FILE cd9bee76d6e44f39
```text
---
name: cja-dimension-analysis
description: >
  Comprehensive dimension analysis and reporting for CJA. Use this skill whenever the user
  wants to analyze one or more dimensions — including cardinality, distribution/skew, trends,
  anomalies, data quality errors, comparisons, and forecasting. Also trigger when someone
  asks "what are the top values for...", "dimension health", "explore this dimension",
  "dimension dashboard", "dimension statistics", "data quality check on a dimension",
  "dimension cardinality", "dimension trends", "dimension skew", "dimension anomalies",
  "compare dimensions", or any similar request to understand what's inside a CJA dimension.
  Produces an interactive HTML dashboard or a markdown report. Works with the CJA MCP server.
license: Apache-2.0
metadata:
  author: Adobe
  version: "1.0"
---
# CJA Dimension Analysis

Analyze one or more CJA dimensions to understand their cardinality, distribution, trends,
anomalies, data quality issues, and forecasts. Produces an actionable report that helps
teams understand what's inside their dimensions and where to focus attention.

## Workflow

Execute phases in order. Each phase is **selectable** — the user can ask for a subset
(e.g., "just cardinality and errors") or the full analysis. Default is all phases.

### Phase 0 — Setup

1. Call `findDataViews` to list available data views. If the user hasn't specified one,
   ask which data view to analyze. Set it with `setDefaultSessionDataViewId`.
2. Ask which dimensions to analyze. Options:
   - **Named dimensions**: "Analyze Page Name and Browser Type"
   - **By ID**: user provides dimension IDs directly
   - **All dimensions**: warn that this may be slow; ask for a limit (default: top 50 by name)
3. Ask which analyses to run (or confirm "all" as the default):
   - Cardinality, Distribution/Skew, Trends, Anomalies, Data Quality, Comparisons, Forecasting
4. Ask for the date range. If the user hasn't specified one, test a few ranges to find data:
   - Try last 30 days, last 90 days, last 6 months, last year — use the first that returns rows.
5. Ask for the primary metric to use for distribution/skew (default: occurrences or visits).
6. Confirm the plan with the user before proceeding.

### Phase 1 — Cardinality

For each dimension:

1. Call `searchDimensionItems(dimensionId, limit: 50000)` to estimate unique value count,
```
END THIRD-PARTY FILE cd9bee76d6e44f39

The third-party file has ended. Everything between the cd9bee76d6e44f39 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2390 of 13154 bytes. © Adobe · Apache-2.0 · https://github.com/adobe/skills/tree/HEAD/plugins/adobe-cja/skills/cja-dimension-analysis/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
