Empieza aquí 🌱

Abre esta carpeta con Claude Code o Cowork y dile a tu asistente: "siembra esta semilla 🌱"

Con eso basta. Tu asistente hace todo lo técnico por ti. Tú solo confirmas cuando te pregunte.

¿Otras formas de pedirlo? "instala esta semilla", "activa este agente", "pon el revisor de QA a funcionar". Te entiende igual.

Esta semilla instala un agente (subagente): un ayudante especializado que tu asistente puede invocar para revisar la calidad técnica de tu contenido antes de que lo apruebes o publiques. Se fija en lo aburrido pero importante —ortografía, gramática, formato, consistencia y que no falte nada— y te devuelve un veredicto claro (PASS / FAIL) con la ubicación exacta de cada error y cómo arreglarlo. Lo que NO hace, a propósito, es meterse con la estrategia, la creatividad o el tono de tu marca: su única pregunta es "¿está bien escrito y bien armado?".

Para el asistente que siembra 🤖

Eres el asistente. Sigue estos pasos con precisión. Esto es un agente de Claude Code / Cowork (un subagente con nombre propio), no un hook ni un script: se instala copiando un solo archivo Markdown a la carpeta de agentes del usuario. La plataforma lo descubre automáticamente al leer esa carpeta.

Paso 1 · Copiar el archivo del kernel

El kernel es un solo archivo: kernel/qa-checker.md. Cópialo a la carpeta de agentes del usuario según su plataforma.

• macOS / Linux (Claude Code o Cowork):

  mkdir -p ~/.claude/agents
  cp kernel/qa-checker.md ~/.claude/agents/qa-checker.md
  

• Windows (Claude Code o Cowork):

  mkdir -p "$USERPROFILE/.claude/agents"
  cp kernel/qa-checker.md "$USERPROFILE/.claude/agents/qa-checker.md"
  

Sin chmod y sin settings.json. A diferencia de un hook, un agente es un archivo de texto que la plataforma lee, no un programa que se ejecute. No necesita permisos de ejecución ni cablearse en settings.json. Con copiarlo a la carpeta agents es suficiente: Claude Code y Cowork lo detectan solos.

Paso 2 · Verificación post-siembra (obligatoria)

No declares "listo" sin correr esto. Confirma que el archivo llegó a su sitio y que su encabezado (frontmatter) quedó bien formado.

grep -m1 '^name:' ~/.claude/agents/qa-checker.md

Salida esperada:

name: qa-checker

En Windows, cambia ~ por "$USERPROFILE". Si no imprime nada, revisa que el archivo se haya copiado a la carpeta agents (no a hooks) y que el nombre sea exactamente qa-checker.md.

Como comprobación adicional en una sesión interactiva de Claude Code, el comando /agents debe listar qa-checker entre los agentes disponibles. Si aparece ahí, ya se puede invocar.

Placeholders y configuración

El kernel trae un solo placeholder, y es opcional:

• <TU-ARCHIVO-DE-APRENDIZAJES> — aparece en la sección "Mejora continua". Sirve si el usuario quiere que el agente vaya guardando los tipos de error que ya ha visto en un archivo propio (por ejemplo ~/.claude/agents/learnings/qa-checker.md), para no dejar pasar dos veces el mismo tropiezo. Si al usuario no le interesa esa memoria manual, déjalo tal cual o borra esa sección: el agente funciona igual, porque ya trae memory: project para memoria automática por proyecto.

Ajustes opcionales que el usuario puede pedirte más adelante (edítalos dentro del .md):

• Modelo — la línea model: sonnet. Revisar calidad técnica es una tarea de lectura cuidadosa, no de razonamiento pesado; por eso el default es un modelo rápido. Cámbialo si el usuario prefiere otro.
• Skill de heurísticas de usabilidad (opcional): si el usuario tiene instalada una skill de heurísticas (por ejemplo un auditor de usabilidad Nielsen + Krug), el agente la aprovecha automáticamente para puntuar la legibilidad con más finura. Si NO la tiene, no pasa nada: el agente trae el método por dentro y evalúa la legibilidad igual. No necesitas instalar nada extra para sembrar esta semilla.

¿Cómo sé que funcionó?

Cuando tu asistente termine, pídele que corra la verificación de arriba y te muestre el resultado. Si aparece name: qa-checker, ya quedó sembrado.

Para probarlo de verdad, la próxima vez que tengas un texto listo para publicar —un post, un correo, un artículo, un carrusel o un guion de video— dile algo como: "dale una última pasada de QA antes de que lo suba" o "chécame ortografía y formato de esto". Tu asistente invocará al qa-checker, que te devolverá un veredicto (PASS / FAIL / PASS CON OBSERVACIONES) con la lista de errores, cada uno con su ubicación exacta y el arreglo sugerido. Lo que no hará —y ese es justo el punto— es reescribirte el contenido ni opinar de si "vende": solo te dice, con precisión, qué está mal escrito o mal armado para que tú lo corrijas. Si todo está limpio, te lo dirá en una sola línea, sin inflar el reporte.