Ux Writing
by ilyasibrahim
Voice, tone, and content guidelines for data/ML dashboards. Covers microcopy, error messages, success states, and data presentation language. Auto-invokes on copy, messaging, content, labels, error messages keywords.
Skill Details
Repository Files
1 file in this skill directory
name: ux-writing description: Voice, tone, and content guidelines for data/ML dashboards. Covers microcopy, error messages, success states, and data presentation language. Auto-invokes on copy, messaging, content, labels, error messages keywords. allowed-tools: Read
UX Writing (Core)
Voice
- Professional yet Accessible - Technical precision without jargon
- Educational - Explain complex concepts clearly
- Evidence-Based - Data-driven with context
- Progress-Oriented - Focus on forward momentum
Tone by Context
| Context | Tone | Example |
|---|---|---|
| Executive | Strategic, narrative | "ML models require quality data for production performance" |
| Analyst | Precise, data-rich | "Retention: discovery → silver dataset" |
| Error | Calm, solution-focused | "Unable to load metrics. Check connection and refresh." |
| Success | Confirming, brief | "Pipeline completed successfully." |
Microcopy Patterns
Buttons
- Primary: "View Dashboard" (not "Click to View")
- Secondary: "Learn More" (not "Read Documentation")
- Destructive: "Delete Dataset" (not just "Delete")
Errors
Structure: Problem + Solution
- "Unable to connect. Check URL and try again."
- "File exceeds 10MB. Compress or split."
Empty States
Structure: Explanation + Action
- "No datasets yet. Upload your first dataset to get started."
Loading
Be specific: "Loading dashboard..." not "Loading..."
Data Presentation
Numbers
- Use commas: 1,234,567
- One decimal for %: 45.2%
- Context: "1,234 records (+12% from last month)"
Trends
- Positive: "+12.5%" or "↑ 450 records"
- Negative: "-8.2%" or "↓ 120 records"
Accessibility
Alt Text
Describe: "Bar chart showing training data distribution" Not: "Image of chart"
Links
Specific: "View dataset documentation" Not: "Click here"
Preferred Terms
| Use | Avoid |
|---|---|
| Dataset | Data set |
| Pipeline | ETL process |
| Real-time | Realtime |
| Training data | Train data |
Version: 2.0.0
Related Skills
Xlsx
Comprehensive spreadsheet creation, editing, and analysis with support for formulas, formatting, data analysis, and visualization. When Claude needs to work with spreadsheets (.xlsx, .xlsm, .csv, .tsv, etc) for: (1) Creating new spreadsheets with formulas and formatting, (2) Reading or analyzing data, (3) Modify existing spreadsheets while preserving formulas, (4) Data analysis and visualization in spreadsheets, or (5) Recalculating formulas
Clickhouse Io
ClickHouse database patterns, query optimization, analytics, and data engineering best practices for high-performance analytical workloads.
Clickhouse Io
ClickHouse database patterns, query optimization, analytics, and data engineering best practices for high-performance analytical workloads.
Analyzing Financial Statements
This skill calculates key financial ratios and metrics from financial statement data for investment analysis
Data Storytelling
Transform data into compelling narratives using visualization, context, and persuasive structure. Use when presenting analytics to stakeholders, creating data reports, or building executive presentations.
Kpi Dashboard Design
Design effective KPI dashboards with metrics selection, visualization best practices, and real-time monitoring patterns. Use when building business dashboards, selecting metrics, or designing data visualization layouts.
Dbt Transformation Patterns
Master dbt (data build tool) for analytics engineering with model organization, testing, documentation, and incremental strategies. Use when building data transformations, creating data models, or implementing analytics engineering best practices.
Sql Optimization Patterns
Master SQL query optimization, indexing strategies, and EXPLAIN analysis to dramatically improve database performance and eliminate slow queries. Use when debugging slow queries, designing database schemas, or optimizing application performance.
Anndata
This skill should be used when working with annotated data matrices in Python, particularly for single-cell genomics analysis, managing experimental measurements with metadata, or handling large-scale biological datasets. Use when tasks involve AnnData objects, h5ad files, single-cell RNA-seq data, or integration with scanpy/scverse tools.
Xlsx
Spreadsheet toolkit (.xlsx/.csv). Create/edit with formulas/formatting, analyze data, visualization, recalculate formulas, for spreadsheet processing and analysis.