convez.ai
SkillDesign & UIIntermediário
andresladino-design

Simetrik Design Studio

andresladino-design/simetrik-design-studio

5 skills Claude Code para design, escrita e análise de produtos

Ver no GitHub
InicialPluginScore · de 0 a 100

Suite de 5 skills Claude Code integrados para design de produtos: UI hub, copywriting UX, heurísticas de usabilidade, onboarding e visualização de dados. Ferramenta colaborativa para equipes de design e produto otimizarem fluxos de trabalho no terminal.

Instalação

$npx convez-ai andresladino-design/simetrik-design-studio

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 6 meses
Versão
v1.0.0
Issues abertas
0
Contribuidores
1

Casos de uso

  • Validar heurísticas de usabilidade em interfaces
  • Gerar copy UX consistente e testado
  • Documentar padrões de design e componentes UI
  • Planejar fluxos de onboarding
  • Visualizar e analisar dados de produto

Veredito

Solução focada e bem estruturada para equipes de design que trabalham com Claude. Os 5 skills complementares cobrem ciclo completo de design, mas requerem integração manual e conhecimento de Claude Code para máximo aproveitamento.

README

A tradução para o português deste README ainda está na fila.

             ████████                                                                                                                                
           ███████████                                                                                                                      █████    
           █████  █████                                                                                                                    ███████   
          █████    ████                                                                                                                       ████   
           ████████████                                                                                                                     █████    
            ██████████                      ███████████████                                                               █████            ████████  
               ████        ██               ██████████████████                                                            █████            ███████   
               ████    ██████████           ██████      ███████          ████              ████                           █████                      
               ████   ████████████          ██████        ██████     ███████████       ████████████   ██████      █████   █████    ██████            
  ███████      ████   ████    █████         ██████         █████    ██████████████    ██████████████   █████      █████   █████  ███████             
███████████    ████   █████   ████          ██████         █████   █████      █████   █████     ████    █████    █████    █████ ██████               
████   █████   ████   ████████████          ██████         █████  █████████████████   █████████         ██████  ██████    ██████████                 
████   █████   ████     ████████            ██████         █████  █████████████████    ████████████      █████  █████     ██████████                 
████████████   ████       ████              ██████        ██████  █████                    ██████████    █████ █████      ████████████               
 ██████████    ████       ████              ██████      ███████    █████      █████  █████      █████     ██████████      █████  ██████              
   █████       ████       ████              ██████████████████     ████████████████  ████████████████      ████████       █████   ██████             
    ██████     ████     ██████              ████████████████         █████████████     ████████████         ██████        █████    ███████           
     ███████   ████  ████████                                            █████            ██████            █████                                    
       ███████████████████                                                                                 ██████                                    
          ██████████████                                                                                ████████                                     
            █████████                                                                                  ███████                                       

simetrik-design-studio

El estudio de diseño de Simetrik que vive en tu terminal. Cinco skills de Claude Code que trabajan juntos para diseñar y escribir el producto.

License: Apache 2.0 Claude Code Skills


¿Qué es esto?

Un monorepo con cinco skills que se complementan para cubrir el flujo completo de diseño y escritura en Simetrik. El protagonista es simetrik-ui — el hub que orquesta un equipo de diseño agentico (Product Designer, UX Research, UX Writer). Los otros cuatro son specialists companion a los que simetrik-ui delega cuando hace falta.

No es un kit genérico. Encapsula la identidad agentizada de Simetrik, el glosario obligatorio (Conciliación, Fuente, Asiento contable, Incidente, Dataset), los bans absolutos (sin sparkles ✨, sin "Powered by AI", sin modal-first), el patrón canónico de navegación, y el design system desyk. Cuando invocas el skill, no es una herramienta lo que abres — es un estudio.


El equipo de diseño

Cuando invocas simetrik-ui, abres un estudio. Hay cuatro roles:

         Tú (sesión principal de Claude Code)
                  ║
                  ║ diriges, decides, presentas al humano final
                  ▼
           ┌──────────────────┐
           │      LEAD        │  ← eres tú asumiendo este rol
           │  (orquestador)   │
           └────┬───┬───┬─────┘
                │   │   │
                ▼   ▼   ▼
       ┌────────────┐  ┌──────────┐  ┌──────────┐
       │  Product   │  │   UX     │  │   UX     │
       │  Designer  │  │ Research │  │  Writer  │
       └────────────┘  └──────────┘  └──────────┘
           síntesis     evidencia    cada palabra
           del Brief    + bans       de la UI
                        Simetrik
RolCuándo entraQué hace
LEAD (tú)Siempre — eres la sesión principalOrquesta el ciclo. Único nodo que toca el mundo exterior: pullea Brain, Linear, Figma, Granola, código del repo. Empaca el contexto en el Brief antes de spawnar a nadie. Aprueba qué specialists activar. Presenta el entregable al humano.
Product DesignerInicio + cierre del cicloRecibe el Brief pre-llenado con contexto. Sintetiza. Completa estructura, alcance, señales de calidad, preguntas de research, decisiones. En el cierre, revisa coherencia entre outputs de specialists.
UX ResearchFase 1, condicionalInvestiga benchmarks (NN/g, Baymard, productos comparables) y patrones establecidos. Aplica bans Simetrik a cada referencia. Devuelve recomendaciones priorizadas con destinatario claro.
UX WriterFase 2, condicionalCada palabra visible: labels, errores, empty states, toasts, confirmaciones, tooltips. Aplica glosario canónico (Conciliación, Fuente, Incidente, Dataset, etc.), rúbrica de evaluación y voz/tono Simetrik.

Roles legacy: IxD, UI Designer, Front Designer, QA Design fueron agentes antes; ahora los asume el LEAD directamente o se delegan a skills companion (frontend-code-review, frontend-component-quality-guard). No te preocupes por ellos — el sistema lo maneja.

La regla de oro: los specialists no fetchean nada del mundo exterior. Solo el LEAD lo hace. Esto evita que un subagente que no puede hablar contigo se quede colgado pidiendo permiso a Linear o invente datos cuando no encuentra algo.


Los 26 subcomandos

Cada subcomando es una intención. Lo invocas con /simetrik-ui <subcomando> <target>.

Build (7) — empezar algo nuevo

SubcomandoPara qué
teachVerifica que tu entorno esté listo (Brain accesible, MCPs vivos, companion skills instalados). Idempotente, sin efectos.
shape <feature>Planeas una feature: discovery socrático con el LEAD + Brief estructurado.
prototype <feature>HTML iterable para validar experiencia rápido.
handoff <target>Especificación implementable consolidada (delega a stories + ux-writer).
craft <feature>Ciclo completo del equipo end-to-end. Discovery → context-gathering → Brief → specialists → síntesis.
documentGenera o actualiza la documentación de diseño del proyecto FE actual.
extract <target>Saca un patrón reusable para proponer a desyk.

Evaluate (2) — entender qué hay

SubcomandoPara qué
critique <target>Review heurístico Simetrik. No toca código.
audit <target>Auditoría técnica: a11y, performance, responsive, contratos desyk.

Refine (7) — pulir lo que ya existe

SubcomandoPregunta central
polish <target>¿Esto está correcto? Pasada final pre-PR.
bolder <target>¿Esto tiene presencia? Más audaz dentro del lenguaje Simetrik.
quieter <target>¿Esto debe gritar? Calmar lo ruidoso.
distill <target>¿Esto debe estar? Quita complejidad funcional (ortogonal al volumen).
harden <target>¿Esto está production-ready? Edge cases, errores, i18n, a11y.
agentize <target>¿Esto se siente Excel? Convertir UI tradicional a UI agentizada. Subcomando estratégico Simetrik.
onboard <target>First-run, empty states activos, activación.

Enhance (6) — agregar carácter

SubcomandoPara qué
animate <target>Motion con propósito pedagógico (durations canónicas 120/200/320ms).
colorize <target>Color principal Simetrik dirigido a atención, no decoración.
typeset <target>Jerarquía tipográfica explícita.
layout <target>Spacing, ritmo, jerarquía visual estructural.
delight <target>Personalidad puntual sin caer en AI slop.
overdrive <target>Ambición máxima dentro de los bans Simetrik.

Fix (3) — arreglar puntos específicos

SubcomandoPara qué
clarify <target>UX copy, labels, errores. Delega al skill ux-writer.
adapt <target>Responsive a breakpoints/devices.
optimize <target>Performance UI. Delega a frontend-code-review.

Iterate (1)

SubcomandoEstado
liveV2, todavía no operativo.

Dos modos de usar el sistema

Hay dos formas de invocar el skill, según lo que necesites hacer:

Modo A — Ciclo completo del equipo

Para features nuevas o serias. Lo invocas con craft o shape:

/simetrik-ui craft bulk-edit de incidentes en Op Center, epic GLE-42

Lo que pasa: discovery socrático con el LEAD → context-gathering (Brain, Linear, Figma, código) → Product Designer escribe el Brief → LEAD aprueba qué specialists activar → UX Research y/o UX Writer trabajan en paralelo → PD cierra con síntesis de coherencia → te entrega 3-4 archivos estructurados.

Output: archivos en <cwd>/.claude/design-team/{briefs,research,copy,implementation}/.

Modo B — Subcomando puntual

Para operaciones específicas sobre código existente. Lo invocas con cualquier subcomando que no sea craft o shape:

/simetrik-ui critique src/oc/features/anomalies/AnomalyCard.tsx
/simetrik-ui polish src/features/catalog/SolutionDetail.tsx
/simetrik-ui clarify locales/es/incidents.json
/simetrik-ui audit src/oc/features/incidents/

Lo que pasa: la sesión principal carga las leyes Simetrik + reglas del componente target, opera directamente sobre el archivo (review verbal o edición puntual). No spawnea al equipo ni genera Brief.

¿Cuál uso? Heurística rápida

Lo que necesitasModoComando típico
Feature nueva con o sin epicEquipo (A)craft o shape
Revisar un componente existenteSubcomando (B)critique
Pulir antes de un PRSubcomando (B)polish
Validar a11y / contratos desykSubcomando (B)audit
Mejorar copy / labelsSubcomando (B)clarify
Diseñar empty states de un móduloSubcomando (B)onboard
Convertir UI "Excel" a agentizadaSubcomando (B)agentize
Una pregunta rápidaSin comandopreguntar directo en chat

Regla mental:

  • ¿Necesitas un artefacto estructurado (Brief, Research Snapshot, Copy Spec)? → Modo A
  • ¿Necesitas código modificado, review verbal, o propuesta puntual? → Modo B

¿Querés el detalle? El simetrik-ui/README.md tiene el pipeline visual paso a paso del Modo A (con los comandos exactos del LEAD, los paths donde aterriza cada artefacto) y 4 ejemplos de interacción real (conversaciones simuladas en cada modo).


Los 5 skills del monorepo

SkillPara qué sirveDetalle
simetrik-uiEl hub. Equipo de diseño agentico + 26 subcomandos + 60 component-rules + 7 leyes raíz.simetrik-ui/
ux-writerCada palabra visible en la UI. Glosario canónico, rúbrica, voz y tono.ux-writer/
ux-heuristicsQuality guard heurístico. Nielsen + leyes UX clásicas + checklist Simetrik.ux-heuristics/
ux-onboardingFirst-run flows, empty states activos, patrones de activación.ux-onboarding/
ux-data-vizVisualización de datos financieros. Selección de chart, composición de tableros, storytelling FinOps.ux-data-viz/

simetrik-ui es el central — los otros cuatro son specialists a los que delega cuando un subcomando lo amerita (ej. clarify → ux-writer). Cada uno también es invocable directo si solo necesitas su especialidad.


Instalación

Los cinco skills con un solo comando (corré desde ~, no desde dentro de un repo git):

cd ~
npx skills add andresladino-design/simetrik-design-studio --all

Esto recorre el repo, encuentra cada SKILL.md, e instala cada uno como skill independiente en ~/.agents/skills/ con symlinks desde ~/.claude/skills/.

Después del install: reinicia tu sesión de Claude Code y ejecuta /simetrik-ui (sin argumento). Vas a ver el Welcome Screen completo con el equipo de diseño + los 26 subcomandos + los dos modos de uso + preguntas socráticas para orientarte. Ese es el "tour" del skill. Detalle en INSTALL.md.

Solo algunos skills

npx skills add andresladino-design/simetrik-design-studio --skill simetrik-ui,ux-writer

Instalación manual

git clone https://github.com/andresladino-design/simetrik-design-studio /tmp/sds
for s in simetrik-ui ux-writer ux-heuristics ux-onboarding ux-data-viz; do
  cp -r /tmp/sds/$s ~/.claude/skills/$s
done

Detalle completo en INSTALL.md.


Invocando los skills companion directamente

Aunque simetrik-ui delega automáticamente al companion cuando un subcomando lo amerita (clarify → ux-writer, etc.), también podés invocar cada companion skill directo si solo necesitas su especialidad:

/ux-writer revisa este copy                     ← solo revisión de copy
/ux-heuristics evalúa esta pantalla             ← solo análisis heurístico
/ux-onboarding diseña el empty state            ← solo onboarding
/ux-data-viz escoge el chart para estos datos   ← solo decisión de viz

Útil cuando no necesitas todo el peso del hub simetrik-ui para una pasada específica.


Prerequisitos

Los skills están diseñados para frontend Simetrik. Mejor experiencia si tienes:

  • Acceso al código Simetrik (fe-solutions-mf, frontend-provider-app)
  • @simetrikinc/desyk-components instalado en el proyecto
  • Opcionalmente: ~/Simetrik/ProductEngineeringBrain/ (vault Obsidian), agentes UxTeam, acceso a Linear, MCPs configurados (Linear, Atlassian, Figma, Granola)

Los skills se degradan con elegancia fuera de ese contexto: aplican lo universal y avisan qué no está disponible.

Para verificar tu entorno antes de arrancar:

/simetrik-ui teach

Companion skills del plugin del equipo

Algunas delegaciones de simetrik-ui apuntan a skills que viven en el plugin del equipo Simetrik (simetrik:*). Si tienes acceso al plugin del equipo, están disponibles automáticamente:

  • simetrik:query-vault — lector del vault Obsidian
  • simetrik:frontend-code-review
  • simetrik:frontend-component-quality-guard
  • simetrik:frontend-desyk-migrate
  • simetrik:frontend-env-setup

Sin acceso al plugin del equipo, el subcomando correspondiente avisa y procede con output degradado.


Estructura del monorepo

simetrik-design-studio/
├── simetrik-ui/         ← el hub: agentes + subcomandos + reglas
│   ├── SKILL.md
│   ├── README.md            ← detalle del flujo, pipeline, ejemplos
│   ├── agents/              ← equipo agentico + protocolo + Brief template
│   ├── laws/                ← 7 documentos transversales
│   ├── component-rules/     ← 60 reglas prescriptivas por componente
│   └── subcommands/         ← 26 subcomandos
├── ux-writer/           ← glosario + rúbrica + voz y tono
├── ux-heuristics/       ← Nielsen + UX laws + checklist Simetrik
├── ux-onboarding/       ← empty states, first-run, activación
├── ux-data-viz/         ← visualización financiera
│
├── README.md            ← este archivo
├── CHANGELOG.md
├── INSTALL.md
├── LICENSE
└── NOTICE.md

Cada skill es autocontenido: tiene su propio SKILL.md (con frontmatter), README.md, y archivos de referencia.


Documentación

  • simetrik-ui (el hub): docs completas en simetrik-ui/README.md. Incluye pipeline visual, dos modos de uso, ejemplos de interacción real, lista de los 26 subcomandos por categoría, y las reglas no negociables.
  • Otros skills: ver el README.md y SKILL.md de cada uno.

Atribución

simetrik-ui está estructuralmente derivado de impeccable de Peter Bakaus (Apache 2.0). El contenido específico de Simetrik (componentes desyk, glosario, leyes de identidad, equipo agentico, ROSSETA, template del Brief) es trabajo original. Ver NOTICE.md para detalle.

Los otros cuatro skills (ux-writer, ux-heuristics, ux-onboarding, ux-data-viz) son trabajo original.

Autor

Andres Ladino, UX Designer en Simetrik. Mantenido como iniciativa personal.

Licencia

Apache 2.0. Ver LICENSE.

Marcas

"Simetrik" y "desyk" son marcas registradas de Simetrik S.A.S. Estos skills no son un producto oficial de Simetrik.

Ver o original no GitHub

Bom para

Relacionados