Subagentes de Claude Code para diseñadores: qué son y cómo armar uno

Un subagente de Claude Code es un asistente especializado que trabaja en su propia conversación, con sus instrucciones y solo las herramientas que tú le das, y que al terminar le devuelve a Claude un resumen. A una persona de diseño le sirve para una cosa concreta: tener revisores con un solo criterio (accesibilidad, tokens, textos, fidelidad con Figma) que miran el trabajo sin arrastrar todo lo que pasó antes en la conversación. Se arma con un archivo Markdown en .claude/agents/.

Datos revisados el 21 de octubre de 2026 contra la documentación oficial de subagentes.

Qué es, en simple

Cuando trabajas con Claude Code, todo lo que lee y hace se acumula en una sola conversación. Un subagente parte de cero: según la documentación, empieza con un contexto aislado, sin tu historial ni los archivos que Claude ya leyó. Claude le escribe un encargo, el subagente trabaja solo y lo único que vuelve a la conversación principal es su resumen.

Para diseño eso tiene dos ventajas:

1. Ojos frescos. Un revisor que no vio cómo se hizo algo no lo justifica: lo mira como lo vería otra persona.
2. Menos ruido. Una auditoría larga de accesibilidad no llena tu conversación con cientos de líneas: te llega la lista de hallazgos.

Subagente o skill

Las dos se escriben en Markdown, pero no son lo mismo:

	Skill	Subagente
Dónde trabaja	Dentro de tu conversación	En una conversación aparte
Qué aporta	Un procedimiento o un script (por ejemplo, calcular el contraste)	Un rol con su criterio y sus herramientas
Qué vuelve	Todo el trabajo queda a la vista	Solo el resumen
Ejemplo	contraste-colores: mide la razón de contraste de cada par de tokens	Un inspector de accesibilidad que revisa el código y devuelve hallazgos

Si ya leíste la guía de skills para diseño UI/UX, la regla práctica es esta: lo que se mide va en una skill; lo que se juzga desde un rol va en un subagente. Y se combinan: un subagente puede usar una skill.

Dónde viven

Ámbito	Ruta	Para qué
Proyecto	.claude/agents/	Ese repositorio; si lo subes a git, lo comparte el equipo
Personal	~/.claude/agents/	Todos tus proyectos en esa máquina
Plugin	carpeta agents/ del plugin	Donde el plugin esté activo

Si dos tienen el mismo nombre, gana el del proyecto sobre el personal, y el personal sobre el del plugin.

El archivo

Es un Markdown con un encabezado en YAML. Solo dos campos son obligatorios: name y description. El cuerpo del archivo pasa a ser las instrucciones del subagente.

Este es un revisor de textos de interfaz que puedes copiar en .claude/agents/revisor-microcopy.md:

---
name: revisor-microcopy
description: Revisa los textos de interfaz (botones, errores, estados vacíos, formularios) de los archivos que le indiquen. Úsalo después de cambiar textos visibles.
tools: Read, Glob, Grep
model: sonnet
---

Eres un revisor de UX writing en español de Chile, con tuteo.
Lee solo los archivos que te indiquen y revisa cada texto visible:

1. ¿Dice qué pasa y qué puede hacer la persona? Un error sin salida es un hallazgo.
2. ¿Usa el mismo nombre para la misma cosa en todo el sitio?
3. ¿El botón dice la acción («Guardar cambios»), no «Aceptar» u «OK»?

Devuelve una tabla: archivo:línea, texto actual, problema, texto propuesto.
No edites archivos.

Qué hace cada campo:

• name: el identificador. Con ese nombre lo llamas.
• description: cuándo Claude debe delegarle trabajo. Es lo más importante: si no dice con claridad cuándo usarlo, Claude no lo elige solo.
• tools: la lista de herramientas permitidas. Si lo omites, hereda todas. Para un revisor, dale solo lectura (Read, Glob, Grep): así no puede cambiar nada aunque se equivoque.
• model: qué modelo usa (sonnet, opus, haiku o inherit). Un revisor de textos no necesita el más caro.

Hay más campos opcionales (permisos, memoria, esfuerzo, trabajar en una copia aparte del repositorio); la documentación los lista todos.

Cómo se usa

• Que Claude lo elija solo: si la tarea calza con la description, Claude lo delega.
• Pedirlo por nombre: «usa el revisor-microcopy para revisar el formulario de registro».
• Con @: escribes @ y eliges el subagente; así te aseguras de que sea ese el que trabaje.

Si creas la carpeta .claude/agents/ con la sesión abierta, reinicia Claude Code para que la vea. Los cambios a un subagente que ya existía se toman sin reiniciar.

Tres revisores que valen la pena para diseño

1. Accesibilidad: busca en el código lo que una herramienta automática no ve bien (botones hechos con div, campos sin etiqueta, foco que desaparece) y devuelve hallazgos con su criterio WCAG.
2. Tokens: encuentra colores y medidas sueltas que deberían ser tokens del sistema y propone cuál usar.
3. Fidelidad: compara la captura de Figma con la de lo construido y separa lo que es error de lo que es una decisión.

La regla para los tres: que no editen. Un revisor que también arregla deja de ser revisor.

Siguiente paso

Las skills gratis en español están en el repositorio público de GitHub, con licencia MIT. Si quieres los revisores ya armados y probados, el kit «Del Figma a producción con Claude Code» trae 6 subagentes (accesibilidad, tokens, fidelidad con Figma, crítica de diseño, textos y uno que explica el código en lenguaje de diseño) y 14 skills. Es de pago; aquí está todo lo que incluye. El kit no está afiliado a Anthropic.