ilyasibrahim/claude-agents-coordination

ux-writing

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

Ver código fuente

Cómo usar

  1. Copia el comando y revisa el paquete antes de instalarlo en tu entorno de agente.
  2. Consulta las herramientas, credenciales y entornos necesarios en el documento original.
  3. Describe las entradas y el resultado deseado; contrasta la salida con las fuentes.
npx skills add https://github.com/ilyasibrahim/claude-agents-coordination --skill ux-writing

Antes de empezar

  • La instalación no incluye suscripción al modelo, cuota API ni permisos sobre tus archivos.
  • Las estrellas e instalaciones reflejan actividad, no una prueba independiente de calidad o seguridad.
Documento original del Skill

Contenido del repositorio de origen con títulos, ejemplos, código, tablas, enlaces e imágenes preservados.

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