ilyasibrahim/claude-agents-coordination

ux-writing

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

Ver código-fonte

Como usar

  1. Copie o comando e verifique o pacote antes de instalar no seu ambiente de agente.
  2. Consulte no original as ferramentas, credenciais e ambientes necessários.
  3. Descreva os dados de entrada e a entrega esperada; confira a saída com as fontes.
npx skills add https://github.com/ilyasibrahim/claude-agents-coordination --skill ux-writing

Antes de começar

  • A instalação não inclui assinatura de modelo, franquia API ou acesso aos seus arquivos.
  • Estrelas e instalações indicam atividade, não um teste independente de qualidade ou segurança.
Documento original do Skill

Renderizado do repositório de origem, preservando títulos, exemplos, código, tabelas, links e imagens.

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