Communitygithub.com

Argus

Habilidad de diseño. Diseña, construye, rediseña, pule o revisa sitios web y pantallas de aplicaciones móviles en cualquier framework: páginas de aterrizaje, tableros, pantallas de app, componentes, formularios, un sistema de diseño.

¿Qué es Argus?

Argus es una habilidad de diseño para agentes de IA que sigue un proceso estructurado para crear y modificar interfaces de usuario. Está diseñada para plataformas como Claude Code, Cursor o Codex, y se activa con solicitudes como "construir una página para X", "agregar una pantalla de configuración", "hacer que esto se vea mejor" o "se ve genérico". La habilidad se basa en cuatro principios fundamentales: construir y revisar el resultado renderizado, tomar inspiración de fuentes externas, generar alternativas toscas y elegir mediante la observación, y mantener un enfoque claro en cada página. Argus se integra con frameworks y convenciones existentes del proyecto, y sigue un flujo de trabajo iterativo que incluye construir, renderizar, revisar, usar y corregir. Además, proporciona reglas estrictas sobre accesibilidad, contenido honesto, y la preservación del comportamiento existente. La habilidad es útil para tareas de diseño que van desde pequeños ajustes hasta la creación de nuevas superficies, y proporciona un reporte final con hallazgos, dirección, y elementos abiertos.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Hamza-Masuadi/argus-skill/tree/HEAD/skills/argus

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿Qué hace Argus?

Conoces las reglas del diseño. Otras cuatro cosas salen mal, y esta habilidad responde a cada una:

  1. No puedes ver lo que haces. Por lo tanto, construye, mira el resultado renderizado, corrige y vuelve a mirar.
  2. Tu primera idea es la primera idea de todos. Así que toma información del exterior: lo que existe, lo que el usuario dice, lo que te muestra.
  3. Juzgas mejor de lo que generas. Así que, para trabajo nuevo, crea alternativas toscas y elige mirando.
  4. Tiendes a lo medio y a lo delgado. Por lo tanto, las páginas nuevas reciben una idea, un movimiento grande y un argumento completo.

1. Mira lo que existe

Antes de cualquier otra cosa, encuentra y declara en una línea:

  • Plataforma: web, o una aplicación móvil (iOS, Android, ambas). Lee el proyecto; nunca asumas.
  • Superficie: Persuadir (marketing, aterrizaje, escaparate), Operar (tablero, herramienta, administración, pantalla de app) o Leer (documentos, artículos).
  • Sistema existente: DESIGN.md, archivos de tema o tokens, componentes compartidos, dos o tres pantallas terminadas.
  • Lo que el usuario proporcionó: capturas de pantalla, enlaces, logotipos, colores de marca, fuentes, fotografías.

Implementa con el framework y las convenciones que el proyecto ya utiliza.

2. Toma la única ruta que encaja

Usa la primera fila que coincida. Lee solo los archivos que nombra.

La tareaHazLee
Un ajuste: un componente, una corrección de espaciado o colorHaz el cambio y míralo. Sin preguntas, informe de una líneaNada, o la parte de craft.md que toca
Un comando con nombre (polish, audit, typeset, colorize, animate, simplify, variants)Sigue el comandoreferences/commands/<nombre>.md y lo que nombra
"Revisa esto" o "critica esto"Informa, no cambies nadareview.md, laws.md, verify.md
"Haz que esto se vea mejor", "se ve genérico", sobre algo que existeEncuentra lo que realmente está mal, luego corrige dentro de la apariencia existenteextend.md sección 3, luego commands/polish.md; para una debilidad clara, el comando correspondiente
Nueva pantalla o componente en un proyecto que tiene una aparienciaExtiende. Sin trabajo de dirección, sin preguntasextend.md; más product.md para superficies Operar, mobile.md para nativo
Nueva superficie Operar sin nada que coincidaPregunta si el resumen está abierto, luego construyeask.md, product.md, craft.md; mobile.md si es nativo
Nueva superficie Persuadir o Leer sin nada que coincidaPregunta si el resumen está abierto, luego el flujo completoask.md, create.md (que incluye structures.md e ingredients.md), web.md o mobile.md; photos.md si las imágenes hacen la venta o se proporcionaron fotos
Un rediseño que el usuario solicitó explícitamenteTrátalo como trabajo nuevo, manteniendo el contenido y el comportamientoLa fila de trabajo nuevo correspondiente, más extend.md sección 1 para inventariar lo que debe sobrevivir

Cada ruta que construye algo termina en el bucle de abajo, con slips.md y verify.md. Los ajustes solo necesitan una mirada.

Cambiar la identidad de un producto existente necesita una solicitud explícita. Sin ella, "haz que destaque" significa mejor trabajo dentro de la apariencia actual.

3. Pregunta (solo trabajo nuevo)

Cuando el resumen deja abierto para quién es, cómo debería sentirse o qué tiene que mostrar el usuario, pregunta antes de diseñar: una ronda, como máximo cuatro preguntas sobre el producto, cada una que se pueda omitir, ninguna sobre fuentes o colores. Para una página nueva, también pregunta en torno a qué debería construirse la primera pantalla (tres enfoques que propones para este tema) y cuántas direcciones quieren ver lado a lado (1, 3 o 5; se recomiendan 3). ask.md las tiene. Omite las preguntas que ya responde el resumen o DESIGN.md.

Si no hay nadie para responder, declara cada suposición y continúa. Nunca esperes en un bucle.

4. El bucle

  1. Construye la primera versión real.
  2. Mira. Renderízala y captúrala a 320, 390 y 1440 de ancho (para nativo, en un simulador o dispositivo del tamaño de un teléfono). Antes de volver a leer el código, escribe lo que es visible.
  3. Verifica con slips.md. Ejecuta los scripts que correspondan (consulta verify.md).
  4. Úsala. Presiona el botón principal, completa el formulario, navega con Tab, encuentra la navegación en ancho de teléfono.
  5. Corrige lo que encontraste y vuelve a mirar. Dos rondas, luego informa lo que queda.

Si no se puede renderizar nada, dilo, verifica la fuente en su lugar y no llames al trabajo verificado. Para trabajo sustancial (una página o pantalla completa) donde existan subagentes, entrega las capturas de pantalla a un revisor nuevo que no haya visto tu razonamiento; sus correcciones cuentan como una de las dos rondas.

Reglas que siempre se cumplen

  • La palabra de quién gana: una instrucción explícita del usuario; luego el sistema existente; luego las respuestas y referencias del usuario; luego la dirección que escribiste; luego los números y listas de esta habilidad. Los mínimos de accesibilidad no se anulan por el gusto, tuyo o de esta habilidad. Algo que el usuario solicitó nunca se reporta como defecto.
  • Contenido honesto. Sin lorem ipsum, y sin pruebas inventadas: testimonios, clientes, logotipos, calificaciones, números de uso. Los hechos que una página necesita (un precio, condiciones de prueba) pueden ser sustitutos plausibles, marcados en un comentario de código y listados en el informe. Los datos de muestra en una demostración, catálogo o tablero son bienvenidos cuando son específicos, y se etiquetan como muestra una vez en pantalla.
  • El restyling nunca cambia el comportamiento. Mantén nombres de campos, ids, enlaces, manejadores, acciones de formulario, hooks de prueba y atributos de accesibilidad.
  • Construye los estados que pueden ocurrir, y todos ellos. Presionado y deshabilitado siempre; hover y foco de teclado donde haya un puntero o un teclado. Cargando, vacío y error donde algo real cargue, pueda estar vacío o pueda fallar. Nunca construyas una llamada de red solo para tener un estado de carga.
  • Mínimos de accesibilidad: contraste de texto 4.5:1; foco de teclado visible; controles de al menos 24px, y 44pt / 48dp en pantallas táctiles; una ruta de movimiento reducido; nada se pierde cuando el texto se agranda. craft.md tiene los números y laws.md el estándar exacto.
  • Verificado significa mirado.

Informe

Encontrado:   plataforma, superficie, sistema existente, lo que el usuario proporcionó
Dirección:    una oración (trabajo nuevo), o qué se reutilizó y qué se agregó (extensión)
Mirado:       qué se renderizó, a qué anchos, qué se usó a mano
Corregido:    lo que atrapó el bucle
Asumido:      hechos sustitutos y datos de muestra, por tipo, o "ninguno"
Abierto:      qué no está hecho o no verificado, y cualquier cosa que una guía indique señalar

Mantén solo estas líneas. Un ajuste recibe una línea.

Archivos

ArchivoContiene
ask.mdLa ronda de preguntas
create.mdTrabajo nuevo Persuadir y Leer: la idea, el movimiento grande, alternativas toscas, la dirección
structures.mdEstructuras de página entre las que elegir, para que las alternativas difieran en forma y no solo en color
ingredients.mdLos roles de token que cada dirección completa, y las opciones de color, tipo, forma y espacio
extend.mdTrabajar dentro de una apariencia existente
product.mdSuperficies Operar: tableros, herramientas, pantallas de app
photos.mdPáginas lideradas por fotografías
web.md, mobile.mdQué va dónde en una página web o una pantalla de teléfono
slips.mdErrores realmente cometidos, por superficie. Se verifica en cada mirada
verify.mdCómo capturar, verificar y revisar; los scripts auxiliares
craft.mdCada número: tipo, color, espacio, movimiento, objetivos
laws.mdQué justifican y qué no las leyes de UX; mitos
tells.mdValores predeterminados comunes de diseño generado
review.md, design-md.mdFormato de crítica; registro de decisiones

Todos están en references/.

Cada ruta en esta habilidad (references/..., scripts/..., assets/...) es relativa a la carpeta que contiene este archivo, no al proyecto del usuario. En Claude Code, esa carpeta es ${CLAUDE_SKILL_DIR}. Al ejecutar un script, usa su ruta completa, por ejemplo node "<carpeta de esta habilidad>/scripts/lint.js" <objetivo>.

Skills relacionados