Contenido detallado
📦 Instalar la skill
Instalar OS Coach es más sencillo de lo que parece: tú copia una carpeta para el lugar donde Claude Code busca tus skills. Un comando, sin build, sin claves de API, sin dependencias. Hecho esto, el comando /os-coach pasa a estar disponible en cualquier carpeta de tu máquina.
🌱 ¿Nuevo aquí?
Una skill del Claude Code (el programa de terminal que le da manos a la IA) es una carpeta con instrucciones que se convierten en un comando de barra, como /os-coach. O terminal es la pantallita de texto donde escribes comandos. cp -r significa "copiar una carpeta entera". Y ~/.claude/skills/ es el cajón donde Claude Code guarda las skills de tu cuenta.
▶ Copy-run · instalar el OS Coach
Objetivo: dejar el comando /os-coach disponible en tu máquina. Ejecútalo en la terminal, desde la carpeta donde descargaste o clonaste el repositorio os-coach.
cp -r <caminho-onde-voce-baixou>/os-coach ~/.claude/skills/
Cambia: <ruta-donde-lo-descargaste> por la ruta real (p. ej.: ~/Downloads). Si ya estás dentro de la carpeta del repo, usa solo cp -r os-coach ~/.claude/skills/.
Cómo verificar: abre Claude Code en cualquier carpeta y escribe /os-coach help. Si explica los comandos, la instalación funcionó. (Si el comando no aparece, comprueba si la carpeta os-coach quedó directamente dentro de ~/.claude/skills/, con el SKILL.md ahí dentro.)
Este es el único paso previo de toda la ruta. A partir de aquí, todo sucede dentro de Claude Code.
Por qué aprender
Porque es la puerta de entrada. Sin copiar la skill, nada de esta ruta funciona. Y el hecho de que sea un solo comando refuerza la premisa del curso: un OS es una instalación sencilla, no ingeniería pesada. No estás instalando un programa; estás poniendo un archivo de instrucciones en un cajón.
Conceptos clave
🧭 Qué hace la skill
Ejecutas /os-coach dentro de cualquier carpeta y dices tu objetivo. La skill entonces hace el trabajo técnico por ti, una capa a la vez: hace de 2 a 3 preguntas en portugués sencillo, espera a que respondas y solo entonces crea los archivos y carpetas reales, explicando qué hizo y por qué. La regla de oro es clara: la skill construye; tú decides.
✓ Lo que SÍ hace el OS Coach
- ✓Crea los archivos y las carpetas por ti, con Write/Edit.
- ✓Pregunta poco, espera y construye cuando respondas.
- ✓Ancla todo en tu objetivo real y en lo que está en la carpeta.
✗ Lo que NO hace el OS Coach
- ✗No habla como un manual ni suelta jerga.
- ✗No te lanza las 6 capas de una sola vez.
- ✗No decide por ti: tú eliges.
💡 Supone que nunca has abierto una terminal
Este es el punto que lo cambia todo: el coach fue diseñado para la persona no técnica. Cuando un término técnico es inevitable, lo define en una frase con una analogía cotidiana. Tú respondes preguntas sencillas; él se encarga de la parte difícil.
Por qué aprender
Porque define el acuerdo entre tú y la herramienta. Saber que tú decides y ella construye te quita el miedo a «tengo que saber programar» y también te mantiene en control: el OS refleja las tus opciones, no una plantilla genérica.
Conceptos clave
⌨️ Los 6 comandos
Todo el teclado de esta ruta cabe en seis verbos. No necesitas memorizar nada más que esto. Cada uno activa un flujo diferente de la skill.
| Comando | Qué hace |
|---|---|
| iniciar <objetivo> | Inicia un OS nuevo en la carpeta actual. El valor es tu objetivo. |
| siguiente | Va a la siguiente capa sin terminar y la entrena. |
| layer <nome> | Salta a una capa específica (identity, substrate, rules, skills, tools, agents). |
| estado | Muestra el mapa de progreso a partir de la memoria. |
| audit | Puntúa todo el OS según el objetivo y da los siguientes pasos. |
| help | Explica qué hace y enumera los comandos (además de su estado, si ya lo hay). |
🔎 La pareja que más usas
En la práctica, el 90% de la ruta es solo iniciar una vez y siguiente varias veces, con un audit cada cierto tiempo. layer e estado son atajos para cuando quieras saltar o solo comprobar dónde estás.
Por qué aprender
Porque, en el fondo, cada módulo de esta trilha es uno de estos comandos en acción. Conocer los seis de antemano te da el mapa: 4.2 es el iniciar, 4.3 a 4.5 son el siguiente repetido, y 4.6 es el audit.
Conceptos clave
🧠 memory.md — la memoria entre sesiones
El corazón del OS Coach es un archivo de texto: el memory.md. Guarda tu objetivo, a capa actual, el estado de cada capa y las decisiones que fuiste tomando. Cada ejecución lo lee primero y lo actualiza por último.
Recreación ilustrativa — el esqueleto de memory.md
# OS Coach Memory **Goal:** nunca mais perder um prazo de entrega **Current layer:** substrate ## Layer status - Identity: solid # CLAUDE.md pronto - Substrate: in progress # compendium.md a destilar - Rules: not started ... ## Decisions (append, newest last) - 2026-06-29 objetivo capturado, identidade escrita
💡 Por qué esto es liberador
Puedes detenerte a mitad de una capa, cerrar todo y volver días después en una sesión nueva. El coach lee el memory.md, sabe exactamente dónde te quedaste y continúa desde ahí. Nada de "¿por dónde iba?".
Por qué aprender
Porque es lo que transforma una conversación volátil en un proyecto persistente. Construir un OS lleva más de una sesión; el memory.md es lo que garantiza que el progreso se conserve entre ellas. De hecho, persistir el estado es una regla de oro innegociable de la skill (tema siguiente).
Conceptos clave
📜 Las 8 reglas de oro
La skill carga ocho reglas que nunca rompe. No necesitas memorizarlas, pero conocerlas te dice qué esperar — y cuando el coach se está comportando correctamente.
sin jerga; define con una analogía cuando hace falta.
2-3 preguntas y luego espera.
ella crea los archivos, no tú.
todo anclado al objetivo y a la carpeta.
actualiza el memory.md en cada turno.
"dónde estás" + el siguiente paso.
en ninguna parte, ni en el chat ni en los archivos.
handle en lugar del valor real.
💡 La regla que más te protege
La regla 8 protege tus datos: si marcas un nombre, correo electrónico o valor como sensible, ese valor exacto nunca se escribe en un archivo de la carpeta. En su lugar va un identificador como «Cliente A». Lo ves en acción en el módulo 4.2.
Por qué aprender
Porque son el carácter del coach. Cuando se detiene y pregunta en vez de adivinar, o se niega a escribir un nombre real, no es un bug: es la regla funcionando. Conocerlas te permite confiar en el proceso y detectar cuando algo se sale del rumbo.
Conceptos clave
🛡️ Los guards
Antes de ejecutar cualquier flujo, la skill revisa algunos protecciones — protecciones que evitan que haga tonterías. Son las que explican por qué el coach a veces detente y pregunta en lugar de simplemente actuar.
Sin memoria + comando incorrecto iniciar
Si ejecutas siguiente, estado o audit en una carpeta sin OS, no lo adivina: avisa que no se ha iniciado nada y pide /os-coach start <objetivo>.
iniciar con el OS ya existente
Nunca sobrescribe en silencio. Muestra el objetivo actual y la capa, y te pregunta si quieres continuar donde lo dejaste o empezar desde cero.
Todas las capas ya sólido
No inventa una séptima capa. Te felicita y sugiere un audit o profundizar en una capa con layer.
Capa que no aplica al objetivo
En vez de inventar trabajo, marca no iniciado con un motivo de una línea y sigue adelante.
Por qué aprender
Porque los guards son lo que hace que el coach seguro ante un uso incorrecto. No puedes borrar por accidente un OS listo ni avanzar a una capa sin base. Cuando te interrumpe, es el guard correcto protegiéndote.
Conceptos clave
🔁 El loop Ask → Build → Persist → Next → Audit
Toda la ruta gira en torno al mismo motor de cinco pasos. Das solo un pequeño paso por turno: el coach pregunta, respondes, él construye el archivo real, persiste en memory.md, señala el siguiente y —cuando quieras— audita, alimentando el ciclo de vuelta.
Cómo leer: los cuatro pasos en ámbar giran en ciclo, y todos pasan por el memory.md en el centro (primero lee, al final escribe). El audit en cian es opcional: puntúa el OS y devuelve el resultado al ciclo. Cada módulo de esta trilha es una vuelta en esa rueda.
▶ Copy-run · tu primera vuelta en el loop
Objetivo: confirmar que la skill esté instalada y ver los comandos con tus propias palabras. Abre Claude Code en cualquier carpeta y escribe:
/os-coach help
Cómo verificar: el coach debe responder en lenguaje sencillo, explicar qué hace y enumerar los 6 comandos. Si ya empezaste un OS en esa carpeta, también muestra tu estado actual. Esa es la luz verde para ir al módulo 4.2 y ejecutar el iniciar de verdad.
Observa que help no crea nada ni necesita un OS: es seguro ejecutarlo en cualquier momento.
Por qué aprender
Porque el loop marca el ritmo de todo lo que viene. Interiorizar "un pequeño paso por turno, siempre guardado" te permite relajarte: no tienes que mantener todo el plan en la cabeza. El coach pregunta, tú respondes y construye. Repite.
Conceptos clave
✅ Resumen del módulo
Siguiente módulo:
4.2 — iniciar: el objetivo pasa a ser la Identidad 🎯