PranavNagrecha/AwesomeSalesforceSkills / skills/admin/data-storytelling-design
data-storytelling-design
VerifiedDesigning data stories and narrative-driven analytics in Salesforce: structuring CRM Analytics dashboards for executive communication, text widgets and conditional highlights for annotation, sequential narrative in Tableau Story sheets, and Einstein Discovery narrative REST endpoints. Trigger keywords: data storytelling dashboard, executive analytics narrative, CRM Analytics text widget annotation, Tableau story sheet, smart data discovery narrative API. NOT for building the Einstein Discovery story or prediction definition - use admin/einstein-discovery-setup. NOT for choosing between Reports, CRM Analytics and Tableau - use admin/einstein-analytics-basics.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 14.1 KB |
| references/examples.md | markdown | 7.5 KB |
| references/gotchas.md | markdown | 9.4 KB |
| references/llm-anti-patterns.md | markdown | 4.8 KB |
| references/well-architected.md | markdown | 3.4 KB |
| scripts/check_data_storytelling_design.pyexecutable | script | 2.2 KB |
| templates/data-storytelling-design-template.md | markdown | 1.4 KB |
references/well-architected.md
View on GitHub# Well-Architected Notes — Data Storytelling Design
## Relevant Pillars
### Operational Excellence
Dashboards that communicate clearly reduce the time executives spend interpreting data and increase the quality and speed of decisions. The Z-pattern and text widget narrative approach are operationally efficient design patterns.
### Trustworthy AI
When using Smart Data Discovery narrative API to generate machine-produced insight text, the Trustworthy AI pillar requires that the narrative is accurate, explainable, and does not misrepresent trends. Machine-generated narratives should be reviewed by a human before being surfaced to executive audiences.
## WAF Alignment
| WAF Area | Guidance |
|---|---|
| User Experience | Apply Z-pattern layout and text widget narrative to reduce cognitive load |
| Efficiency | Pre-compute insights; do not require executives to calculate answers mentally |
| Consistency | Use the same color thresholds and layout patterns across all dashboard pages |
## Cross-Skill References
- `admin/analytics-dashboard-design` — Use for chart type selection and SAQL step configuration — the technical layer below storytelling
- `admin/analytics-kpi-definition` — Use to define KPI formulas and metric logic before designing narrative around them
- `agentforce/einstein-discovery-development` — Use for Einstein Discovery story creation and narrative REST API integration
## Official Sources Used
Read for this revision (2026-10-03):
- Analytics Dashboard JSON Developer Guide (Summer '26): https://resources.docs.salesforce.com/262/latest/en-us/sfdc/pdf/bi_dev_guide_json.pdf. Widget `type` list, text and number widget parameters, bindings in the apex step example, `gridLayouts` and `selectors`, `mobileDisabled`, saql step example, apex step limitations.
- Analytics Platform Setup Guide (Spring '26): https://resources.docs.salesforce.com/262/latest/en-us/sfdc/pdf/bi_admin_guide_setup.pdf. Lens and Dashboard Limits (default table rows, 4 MB JSON, components per dashboard); CRM Analytics on Mobile Devices.
- Einstein Discovery REST API Developer Guide (Spring '26), local corpus: `knowledge/imports/bi-dev-guide-rest-sdd.md`. Narrative Resource (`POST /smartdatadiscovery/narrative`, API 51.0).
- CRM Analytics REST API Developer Guide (Summer '26): https://resources.docs.salesforce.com/262/latest/en-us/sfdc/pdf/bi_dev_guide_rest.pdf. Overview pointer to the smartdatadiscovery API.
- Metadata API Developer Guide, Version 67.0: https://resources.docs.salesforce.com/262/latest/en-us/sfdc/pdf/api_meta.pdf. WaveDashboard (unsupported `.wdash` modifications, step-removal deployment failure, suffix, `application`), WaveApplication, WaveDataset.
- Tableau Help, Stories: https://help.tableau.com/current/pro/desktop/en-us/stories.htm
- Tableau Help, Create a Story: https://help.tableau.com/current/pro/desktop/en-us/story_create.htm
- Tableau Help, Tableau Pulse Release Notes: https://help.tableau.com/current/online/en-us/pulse_intro.htm
Listed in the original version and not re-read:
- CRM Analytics Design Trailhead, Principles of Good Design: https://trailhead.salesforce.com/content/learn/modules/analytics-app-design/principles-good-design (HTTP 404 on 2026-10-03).
- CRM Analytics App Structuring and Design Concepts: https://trailhead.salesforce.com/content/learn/modules/analytics-app-design/structure-your-app (HTTP 404 on 2026-10-03).
- Salesforce Well-Architected Overview: https://architect.salesforce.com/well-architected/overview
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| deprecation-and-migrationaddyosmani/agent-skillsManages deprecation and migration. Use when removing old systems, APIs, or features. Use when migrating users from one implementation to another. Use when migrating a database schema in production, such as renaming or dropping a column without downtime (expand/contract). Use when deciding whether to maintain or sunset existing code. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| performance-optimizationaddyosmani/agent-skillsOptimizes application performance across frontend, backend, queries, and databases. Use when performance requirements exist, when you suspect performance regressions, when Core Web Vitals or load times need improvement, when N+1 query patterns need fixing, or when profiling reveals bottlenecks. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| agent-cost-reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |
| agent-cost-reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |