ilyasibrahim/claude-agents-coordination

ux-writing

Voice, tone, and content guidelines for data/ML dashboards.

Vedi sorgente

Come usare

  1. Copia il comando e controlla il pacchetto prima di installarlo nel tuo ambiente agente.
  2. Controlla strumenti, credenziali e ambienti richiesti nel documento originale.
  3. Descrivi input e risultato desiderato; confronta l’output con le fonti.
npx skills add https://github.com/ilyasibrahim/claude-agents-coordination --skill ux-writing

Prima di iniziare

  • L’installazione non include abbonamenti, quote API o accesso ai file.
  • Stelle e installazioni indicano attività, non un test indipendente di qualità o sicurezza.
Documento Skill originale

Contenuto dal repository con titoli, esempi, codice, tabelle, link e immagini preservati.

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

ContextToneExample
ExecutiveStrategic, narrative"ML models require quality data for production performance"
AnalystPrecise, data-rich"Retention: discovery → silver dataset"
ErrorCalm, solution-focused"Unable to load metrics. Check connection and refresh."
SuccessConfirming, 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

UseAvoid
DatasetData set
PipelineETL process
Real-timeRealtime
Training dataTrain data

Version: 2.0.0