🌱 Empieza aquí

Dile a tu asistente: "siembra esta semilla 🌱"

Eso es todo de tu parte. Tu asistente hace lo técnico; tú solo conversas.

¿Otras formas de decírselo? "instala esta habilidad", "pon a funcionar el auditor de repos", "haz el setup de esto". Te entiende igual.

Cuando termine, salta a la sección "¿Cómo sé que funcionó?" al final.

Para el asistente que siembra

Eres el asistente AI de la persona dueña de esta semilla. Estás instalando un skill (habilidad): un conjunto de instrucciones que tú lees y ejecutas cuando la persona te pide auditar la salud de sus repositorios (repos) git locales. No es un script que corre solo; es un manual que te vuelve capaz de revisar sus proyectos y reportar hallazgos, sin modificar ni subir nada por tu cuenta. Sigue estos pasos con precisión y no le pidas a la persona que ejecute comandos: hazlo tú y repórtale en lenguaje simple.

Placeholders que debes resolver antes de empezar

| Placeholder | Qué es | Cómo resolverlo | |---|---|---| | <TU-CARPETA-DE-CLAUDE> | La carpeta de configuración del asistente. | En Claude Code y Cowork suele ser ~/.claude. Si la persona tiene otra, úsala. | | <TU-CARPETA-DE-REPOS> | Dónde viven los proyectos de código de la persona. | Pregúntale o detéctalo (típico: ~/code, ~/Documents/GitHub, ~/projects, ~/repos). |

Paso 1 · Copiar la habilidad a la carpeta de skills

Un skill vive en su propia subcarpeta dentro de skills/, y el archivo debe llamarse exactamente SKILL.md. Copia el kernel a su lugar:

mkdir -p "<TU-CARPETA-DE-CLAUDE>/skills/github-health"
cp kernel/SKILL.md "<TU-CARPETA-DE-CLAUDE>/skills/github-health/SKILL.md"

Un skill no necesita permiso de ejecución (chmod) ni registrarse en settings.json: no es un script ni un hook. Con solo colocar el SKILL.md en la carpeta skills/, tu asistente lo descubre y lo activa cuando la persona use una de sus frases disparadoras ("audita mis repos", "github health", etc.).

Paso 2 · Anclar la carpeta de repos de la persona

El skill necesita saber dónde viven los proyectos. Averigua <TU-CARPETA-DE-REPOS> (tabla de arriba) y déjalo anotado donde tu asistente lo recuerde entre sesiones (por ejemplo, en el archivo de contexto/memoria que lees al inicio). Así, la próxima vez que la persona pida una auditoría, ya sabes dónde buscar sin volver a preguntar.

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

Confirma que el archivo quedó en su lugar y que su encabezado es válido:

# a) El archivo existe en la ruta correcta
ls -l "<TU-CARPETA-DE-CLAUDE>/skills/github-health/SKILL.md"
# Esperado: la línea muestra el archivo (no "No such file or directory")

# b) El encabezado del skill es correcto (nombre y descripción)
head -n 3 "<TU-CARPETA-DE-CLAUDE>/skills/github-health/SKILL.md"
# Esperado: la primera línea es "---" y la segunda empieza con "name: github-health"

Luego haz una prueba real de comportamiento sobre un repo de la persona (solo lectura, no cambia nada):

# Elige cualquier proyecto git de <TU-CARPETA-DE-REPOS> y revisa su estado
cd "<UN-REPOSITORIO-GIT-CUALQUIERA>"
git status --short --branch
git log -1 --format="último commit: %ci"

Con esa salida a la vista, produce un mini-reporte de una o dos líneas siguiendo la estructura del skill (por ejemplo: "Repo limpio, último commit hace 3 días, sin commits pendientes de subir. Salud: 10/10."). Si logras leer el estado del repo y resumirlo sin modificar ni subir nada, la siembra quedó lista. Repórtaselo a la persona en una línea.

Placeholders que debes reemplazar por valores reales:

| Placeholder | Qué es | |---|---| | <TU-CARPETA-DE-CLAUDE> | La carpeta de configuración del asistente (normalmente ~/.claude). | | <TU-CARPETA-DE-REPOS> | La carpeta donde viven los proyectos de código de la persona. | | <UN-REPOSITORIO-GIT-CUALQUIERA> | Cualquier proyecto git dentro de esa carpeta, para la prueba. |

¿Cómo sé que funcionó?

De ahora en adelante, cuando le digas a tu asistente algo como "audita mis repos" o "¿qué proyectos tengo estancados?", él va a revisar tus proyectos de código y te va a entregar un reporte claro: cuáles tienen trabajo sin guardar, cuáles no has subido a la nube, cuáles tienen documentación vieja que ya no coincide con el código.

Lo importante: solo mira y te avisa; nunca toca, borra ni sube nada por su cuenta. Tú siempre decides qué hacer con cada hallazgo. Es como tener a alguien ordenado que, cada tanto, revisa que ninguno de tus proyectos se te esté quedando atrás o a medio guardar. 🫡