Simetrik Design Studio
andresladino-design/simetrik-design-studio
5 skills Claude Code para design, escrita e análise de produtos
Ver no GitHubSuite 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-studio1 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
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.
¿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
| Rol | Cuándo entra | Qué hace |
|---|---|---|
| LEAD (tú) | Siempre — eres la sesión principal | Orquesta 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 Designer | Inicio + cierre del ciclo | Recibe 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 Research | Fase 1, condicional | Investiga benchmarks (NN/g, Baymard, productos comparables) y patrones establecidos. Aplica bans Simetrik a cada referencia. Devuelve recomendaciones priorizadas con destinatario claro. |
| UX Writer | Fase 2, condicional | Cada 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
| Subcomando | Para qué |
|---|---|
teach | Verifica 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. |
document | Genera 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
| Subcomando | Para 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
| Subcomando | Pregunta 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
| Subcomando | Para 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
| Subcomando | Para 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)
| Subcomando | Estado |
|---|---|
live | V2, 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 necesitas | Modo | Comando típico |
|---|---|---|
| Feature nueva con o sin epic | Equipo (A) | craft o shape |
| Revisar un componente existente | Subcomando (B) | critique |
| Pulir antes de un PR | Subcomando (B) | polish |
| Validar a11y / contratos desyk | Subcomando (B) | audit |
| Mejorar copy / labels | Subcomando (B) | clarify |
| Diseñar empty states de un módulo | Subcomando (B) | onboard |
| Convertir UI "Excel" a agentizada | Subcomando (B) | agentize |
| Una pregunta rápida | Sin comando | preguntar 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.mdtiene 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
| Skill | Para qué sirve | Detalle |
|---|---|---|
| simetrik-ui | El hub. Equipo de diseño agentico + 26 subcomandos + 60 component-rules + 7 leyes raíz. | simetrik-ui/ |
| ux-writer | Cada palabra visible en la UI. Glosario canónico, rúbrica, voz y tono. | ux-writer/ |
| ux-heuristics | Quality guard heurístico. Nielsen + leyes UX clásicas + checklist Simetrik. | ux-heuristics/ |
| ux-onboarding | First-run flows, empty states activos, patrones de activación. | ux-onboarding/ |
| ux-data-viz | Visualizació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-componentsinstalado 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 Obsidiansimetrik:frontend-code-reviewsimetrik:frontend-component-quality-guardsimetrik:frontend-desyk-migratesimetrik: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.mdySKILL.mdde 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.