plugin · productivity

embassy

Amalgama's design system, Embassy. One door: /embassy:start asks what you need and runs the right thing, or sets up a new project with a client brand. Eight skills — start (entry point + kickoff), screen (build or redesign one, deciding what it IS first against named UX heuristics), artifact (deliverables, no repo), review, break, explain, eval, and design-quality-review (four-dimension audit, user-invoked) — plus a rollout agent. Web, React Native and Flutter.

v1.29.0
Versión
8
Skills
1
Agentes
productivity
Categoría

Skills

Cada skill se invoca con su slash command o cuando la descripción calza con lo que pedís.

/artifact

Entregables on-brand sin clonar nada: design.md + API acotada de clases + CSS por CDN.

SalidaUn HTML autocontenido, on-brand, verificado contra la taxonomía de fallas. Si es una pantalla de app, el preview en marco de teléfono a 390px.
FormatoHTML de un solo archivo · sin build · sin repo
vos ›armá una propuesta para SimpleFit
vos ›necesito un reporte del proyecto con nuestra marca
vos ›hacé un one-pager con estos resultados
/break

Un componente, todos sus estados de una vez, en una página que es el entregable. Los ejes salen de la regla del componente; el eje de marca en claro y oscuro va siempre.

SalidaUna página con cada escenario etiquetado y lo que se rompió anotado encima, más una tabla de hallazgos con su dueño.
FormatoPágina descartable + tabla · no modifica el componente
vos ›rompé el select
vos ›probá la card de vacante con contenido real
vos ›¿esto aguanta la marca de Megatlón en oscuro?
/design-quality-review

Orquesta la auditoría de cuatro dimensiones. Resuelve los inputs, junta el recon, despacha los cuatro scorers, arma el payload y se lo pasa al motor de scoring.

SalidaCuatro puntajes independientes y un veredicto general, más el archivo de la corrida y un reporte HTML que se abre en el navegador.
FormatoReporte HTML + archivo JSON de la corrida en .design-quality/
vos ›/design-quality-review con la URL de la app
vos ›/design-quality-review + URL, link al DS, repo y contexto
/eval

El loop de medición: escenarios fijos, baseline guardado, corridas pareadas y conteo de fallas.

SalidaUna corrida con conteo de fallas por escenario, el delta contra el baseline y las correcciones propuestas.
FormatoCorridas + reportes en runs/ · requiere el repo
vos ›corramos el eval del DS
vos ›medí si el cambio en design.md mejoró algo
vos ›sacá el baseline de los escenarios
/explain

Ingeniería inversa de una UI ajena, con cada dato marcado como medido, derivado o inferido — y el puente a Embassy: qué existe, qué se compone y qué falta de verdad.

SalidaLas capas del efecto en orden de pintado con su técnica, y el mapeo a componentes y tokens de Embassy.
FormatoExplicación · no escribe código de producción
vos ›cómo está hecha la transición de esta página
vos ›el cliente mandó esta referencia, ¿se puede con Embassy?
vos ›cómo hicieron este gradiente
/review

Auditoría con criterio observable y compartido. Es el juez que también usa `eval`.

SalidaReporte de hallazgos con ID de falla, severidad, evidencia, regla y arreglo propuesto.
FormatoReporte · no modifica código salvo pedido explícito
vos ›revisá esta pantalla contra el DS
vos ›esto no parece de Amalgama, ¿qué está mal?
vos ›auditá este PR antes de mergear
/screen

Diseña, rediseña o migra pantallas con el design system de Amalgama (Embassy) — primero decide qué es la pantalla contra heurísticas de UX con nombre, y solo después la construye con tokens y wrappers leídos del repo.

SalidaEl diagnóstico de la pantalla (problemas, ley citada, movimientos) y la UI construida con tokens reales del design system, sin colores ni fuentes inventadas.
FormatoCódigo · lee el repo del design system en cada sesión
vos ›mejorá esta pantalla, no se entiende
vos ›aplicá el design system acá
vos ›migrá esta pantalla a Embassy
/start

Por acá se entra. Si no sabés qué necesitás te pregunta y arranca lo que corresponda; si venís a configurar un proyecto, te guía de a una pregunta y sale con el tema de marca, el layout base, el DESIGN.md y el preview para mostrarle al cliente.

Salidael CSS de marca del cliente · DESIGN.md · layout base · theme-preview.html · bloque para el CLAUDE.md del proyecto · reporte de verificación. En apps nativas, además, los tokens exportados a src/theme.
FormatoConversación guiada · escribe archivos en el repo del proyecto
vos ›no sé por dónde empezar
vos ›arranquemos este proyecto con el design system de Amalgama
vos ›necesito Embassy white label para SimpleFit

Agentes

Subagentes que este plugin despacha internamente durante sus flujos.

rollout

Roll out Amalgama's design system (also called "Embassy" or "Embassy UI" — https://github.com/amalgamaco/amalgama-design-system) across an entire existing project — survey the UI surface, wire up tokens/base/components CSS, replace hardcoded colors/fonts/radii/shadows with tokens, swap ad-hoc components for DS equivalents, and apply the brand layer. Invoke when the user wants to "use Amalgama DS in this project", "a…

¿Cómo habilitar este plugin?

Una vez activo, sus skills se disparan solos cuando lo que pedís encaja, o los forzás con su slash command.

embassy ya viene activo por default. Si no lo ves en tu sesión, revisá que el toggle siga prendido.

App de Claude

escritorio y web
  1. Abrí Customize y entrá a Organization plugins.
  2. Tocá + Plugins — ahí aparecen los plugins de Amalgama.
  3. Prendé el toggle de embassy. Es por persona: lo activás solo para vos.

Si el plugin no está en el catálogo del org, usá el botón + al lado del cuadro de texto → PluginsAdd plugin, y manejalos después desde Manage plugins.

Claude Code (CLI)

terminal · VS Code · JetBrains
# una sola vez, para registrar el marketplace
/plugin marketplace add amalgamaco/claude-code-plugins

# este plugin
/plugin install embassy@amalgama-plugins

Si el resumen del install dice Run /reload-plugins to activate, corré /reload-plugins. Después los skills se invocan como /embassy:skill.

← sales
pos-toolbox →