Skills que se quedan y la terminal sin miedo

Segunda píldora de una mentoría real, anonimizada. El agente ya está instalado: ahora toca el día a día. Qué es exactamente una skill y cómo se entrena a base de correcciones, qué es un CLI y los comandos básicos de terminal, por qué una carpeta por proyecto lo cambia todo, cómo retomar el trabajo de ayer y cómo dejarlo a salvo en GitHub.

Empezar el repaso

El encargo de la mentoría

~2 min

Esta píldora es la continuación de la sesión en la que instalamos el primer agente de IA. Allí el objetivo era llegar a tener un agente funcionando; aquí el objetivo es otro: trabajar con él sin perderse.

El caso, en tres golpes
  1. 01 Contexto

    Segunda sesión con el mismo perfil no técnico. El agente ya está instalado y funcionando; la duda ahora no es qué es la IA agéntica, sino cómo se trabaja con ella el día a día sin perderse.

  2. 02 Necesidad

    Entender qué es exactamente una skill y dónde vive, saber moverse por la terminal sin pánico, no perder el trabajo de ayer al abrir el ordenador hoy y tener el material a salvo en algún sitio.

  3. 03 Solución

    Cuatro comandos de terminal, una regla de oro (una carpeta por proyecto), el bucle de corrección que hace crecer la skill, y GitHub como red de seguridad. Con eso ya se trabaja de verdad.

Qué es de verdad una skill

~4 min

Una skill es un archivo de texto. Nada más. Un documento en Markdown, que se lee como un Google Docs cualquiera, donde está escrito cómo se hace una tarea concreta. Lo que la hace potente no es el formato: es que persiste entre sesiones y entre herramientas. Se la enseñas hoy a una IA y mañana otra IA distinta la aplica igual.

La definición corta: una skill es un comportamiento predecible que sobrevive al cierre de la conversación. Es la herramienta más potente que tenemos hoy para afinar la IA en un aspecto muy concreto, y no requiere programar nada: es lenguaje natural.

Muchos documentos que se llaman entre sí

Por debajo, una skill no deja de ser un prompt, pero mucho más denso: no un párrafo, sino varios documentos con contexto, ejemplos y reglas que enlazan a otros documentos, como los enlaces de la Wikipedia. Por eso vive en tu ordenador, en carpetas, y no dentro de una web.

Entrenarla: la campana de Pavlov

~4 min

El bucle es siempre el mismo: le pides algo, te lo devuelve, y tú corriges. La parte que casi todo el mundo se salta es la última: decirle explícitamente que incorpore esa corrección a su habilidad. Si no se lo pides, puede que lo guarde y puede que no. Para forzarlo, se le dice.

Prompt de corrección · cerrar el bucle para que el aprendizaje se quede
El gráfico que has hecho no es el que te pedí: los meses tienen
que ir en el eje horizontal y los ingresos en el vertical, y el título
va arriba a la izquierda, no centrado.

Corrígelo. Y cuando lo tengas bien, incorpora esta corrección a tu
habilidad para que la próxima vez te salga así a la primera.

Como enseñar a un niño, o adiestrar a un perro

Haces sonar la campana. "Así no se hace": lo aprende. "Muy bien, así sí": lo aprende también. Pero el aprendizaje solo se consolida si le dices que lo integre en su habilidad. Lo que va evolucionando ahí no es el resultado de hoy: es la forma de proceder. Y eso es exactamente lo que se guarda en la skill.

Y cuando empiece a liarla, corrige también. El entrenamiento no termina nunca: la skill mejora en las dos direcciones, tanto cuando acierta como cuando se desvía.

Mantenerla: optimizar y podar

~3 min

Una skill que lleva meses creciendo acaba siendo un montón de información, y toda esa información ocupa contexto. Más contexto son más tokens, y los tokens son la moneda con la que se paga cada mensaje. Hoy hay modelos que aceptan hasta un millón de tokens de contexto, así que no es un drama, pero conviene hacer limpieza.

Cada pocas semanas: "mejora esta habilidad, simplifícala y quita lo que haya quedado obsoleto". Las reglas viejas que ya no aplican no son neutras: empeoran el resultado.

Qué es un CLI y los comandos básicos

~6 min

Abres el ordenador, aparece la pantalla negra de Warp y el primer instinto es cerrarla. Antes de nada, el nombre de lo que estás viendo: eso es un CLI, una interfaz de línea de comandos. Y no es más que otra forma de darle órdenes al ordenador.

Botones frente a palabras

La interfaz a la que estás acostumbrado se llama GUI: ventanas, iconos y ratón. Ves las opciones y eliges una. Un CLI hace exactamente lo mismo, pero en vez de señalar, escribes: teclas la orden, pulsas Enter y se ejecuta. No hay nada oculto debajo, es la misma máquina: cada vez que arrastras un archivo a una carpeta, por debajo se está ejecutando un comando como los de aquí abajo.

Por qué te importa a ti: los agentes de IA (OpenCode, Claude Code, Codex) son CLIs. No tienen ventana con botones: se lanzan escribiendo su nombre en la terminal. Aprender a moverte por aquí es literalmente el precio de entrada, y son diez minutos.

Todos los comandos se escriben igual: el nombre del comando, un espacio y sobre qué quieres aplicarlo. A veces se añaden opciones, que se reconocen porque empiezan por guion. Así que mkdir clase-julio se lee "crea la carpeta clase-julio", y opencode --continue se lee "abre OpenCode, y hazlo continuando la conversación anterior".

Los cuatro que hacen falta de verdad
cdchange directory
Entrar en una carpeta. Es el equivalente a hacer doble clic en el Finder o el Explorador: cd Github te mete dentro de esa carpeta.
mkdirmake directory
Crear una carpeta nueva: mkdir espacio y el nombre. Lo mismo que crearla a mano en el escritorio, pero sin soltar el teclado.
lslist
Ver qué hay dentro del sitio donde estás. Cuando no recuerdes dónde dejaste algo, este es el primero que se escribe.
Ctrl + Cdos veces
El freno de emergencia: para lo que se esté ejecutando en la terminal, sea el agente, un script de Python o lo que sea. Pulsado dos veces cierra del todo.

Con estos cuatro ya puedes trabajar. Los de abajo son comodidad, no obligación.

Cuatro más, para cuando te pierdas
pwdprint working directory
Te dice en qué carpeta estás ahora mismo. El "¿dónde estoy?" de la terminal, para cuando te has perdido navegando.
cd ..subir un nivel
Salir de la carpeta actual hacia la de arriba. Los dos puntos significan "la carpeta padre"; cd sin nada te devuelve a tu carpeta personal.
open .en Mac
Abre en el Finder la carpeta donde estás, para verla con ventanas e iconos. En Windows el equivalente es start . y en Linux xdg-open .
clearlimpiar
Vacía la pantalla cuando se ha llenado de texto. No borra nada de tu trabajo, solo deja la ventana limpia.

El punto suelto significa 'aquí, la carpeta en la que estoy'.

Teclas que ahorran más que cualquier comando
Tabautocompletar
Escribes las primeras letras del nombre de una carpeta y pulsas Tab: la completa sola. Evita el 90% de los errores por escribir mal un nombre.
↑ / ↓historial
Recupera los comandos que ya escribiste antes, sin tener que acordarte de ellos ni volver a teclearlos.
Ctrl + Cparar
El freno de emergencia. Si algo se queda colgado o se está ejecutando algo que no querías, esto lo corta.
exitsalir
Cierra la sesión de la terminal de forma ordenada. También vale cerrar la ventana: no se rompe nada.

Tab y la flecha arriba son las dos que más se usan a diario, con diferencia.

El freno de emergencia importa: saber parar un proceso con Ctrl + C dos veces quita casi todo el miedo. Nada de lo que pase en esa ventana es irreversible si sabes cerrarla. Y si te pierdes, tienes al agente delante: se le pregunta "¿dónde estoy?" o "ábreme la carpeta de ayer" y lo resuelve él.

Una carpeta por proyecto

~3 min

Esta es la regla de oro de la sesión: cada vez que empieces algo nuevo, créale su carpeta y lanza el agente dentro. La puedes crear con mkdir o a mano en el Finder, da igual. Lo importante es lo que consigues: que todo el proyecto quede autocontenido en un sitio.

La carpeta es el contexto

Todo lo que trabajas dentro de esa carpeta es el contexto inicial que le das a la IA. No tienes que explicarle nada de lo de ayer: se lo cuentan los archivos, porque los escribió o los modificó él. Además, cualquier cambio queda acotado a esa carpeta, que es justo lo que quieres cuando estás aprendiendo.

Sesión y carpeta no son lo mismo

~3 min

Confundir las dos cosas es el error clásico. La carpeta es dónde vive el proyecto y persiste siempre. La sesión es la conversación abierta con el agente, y puedes cerrarla y abrir otra sin perder nada: mientras estés en la misma carpeta, el trabajo sigue ahí.

Para retomar lo de ayer casi todos los agentes tienen una opción de continuar la última conversación: se escribe el nombre del agente seguido de la opción de continuar (a menudo -c o --continue). Cada herramienta la llama a su manera, así que si no la encuentras, pídele al propio agente que te liste sus comandos.

Instalar skills que ya existen

~3 min

Antes de entrenar la tuya, mira si ya está hecha. Hay portales comunitarios llenos de skills entrenadas por otras personas, y el proceso de instalación es sorprendentemente tonto: buscas la que te interesa, copias lo que te dan y se lo pegas al agente diciéndole "instálate esta skill". Con eso tira.

Recursos
  • Web skills.sh · portal de skills listas para instalar: buscas por tema, copias el comando y se lo pasas a tu agente.
  • Web Warp · la terminal amigable donde vive el agente: crear carpetas, moverte y lanzar programas sin sentirte en una película de hackers.
  • Web OpenCode · agente de IA open source con cuota gratuita; el de la sesión, y el que mejor recuerda sesiones anteriores.
  • Web Google Antigravity · alternativa con Gemini: cómoda si ya pagas Gemini Premium, aunque no todas las opciones de sesión son iguales.
Ojo con lo que instalas: una skill es un documento que le dice a la IA cómo comportarse, así que léela antes de pegarla igual que leerías un contrato corto. Si viene de un sitio que no conoces, mejor no.

Guardar el trabajo en GitHub

~3 min

Si el proyecto vive en una carpeta de tu ordenador, un disco roto se lo lleva por delante. La red de seguridad es GitHub: una copia del proyecto con todo su historial. No hace falta que aprendas Git: se lo pides al agente en castellano y lo hace él.

Prompt · subir el proyecto a GitHub
Sube esta carpeta a GitHub en un repositorio privado.
Si ya existe, actualízalo con los cambios de hoy.

Commit y push, o simplemente 'súbelo'

El término técnico son dos pasos: commit (guardar una foto de los cambios con un mensaje) y push (empujarla a GitHub). Pero a efectos prácticos basta con decir "actualízalo en GitHub" y el agente encadena los dos. Para comprobar si lo ha hecho, entra en el repositorio y mira la fecha del último cambio.

Di siempre "privado". Si no lo especificas, puede crearte el repositorio público y tu trabajo queda a la vista de cualquiera. Es la única precaución de todo el paso, y es importante.
Recursos
  • Web GitHub · donde vive la copia de seguridad de tus proyectos, con historial de cambios. Los repositorios privados son gratis.

De la grabación al material

~4 min

Última pieza, y la que más rendimiento da. Una transcripción automática no es perfecta, pero acierta lo suficiente: y en cuanto ese texto existe, se lo puedes pasar a otra IA para que haga lo que quieras con él. Un resumen, un informe, un post, un PDF, una web.

Cuatro horas de clase convertidas en esta página

El ejemplo más honesto es el que estás leyendo. Las páginas de recursos de mis clases salen de la grabación de la sesión: se transcribe, se le pasa entera al agente y él monta la página con sus temas, su quiz y su glosario. Lo mismo sirve para una videollamada de trabajo o para la charla de un congreso que estás viendo en diferido.

Recursos
  • Web Meetily · transcribe reuniones en local, sin mandar el audio a ningún servidor. Tiene versión de pago; la gratuita se instala desde el código fuente.
Coge el audio del sistema, no solo el micrófono: así funciona igual con una videollamada o con un vídeo que estés viendo. Y si el contenido es sensible, que la transcripción sea local: el audio no sale de tu ordenador.

Tu plan de acción

~2 min

El orden por el que yo empezaría mañana. Márcalo a medida que lo completes: se guarda en tu navegador, así que puedes volver y seguir por donde ibas.

Pasos, en orden

Marca lo que vayas completando. Se guarda en tu navegador, así que al volver sigue aquí.

0/7 completado
Repaso

Repaso rápido

Cuatro preguntas para fijar lo esencial. No hay nota ni castigo: si fallas, te explico el porqué.

Repaso · Pregunta 1/4

Le has enseñado a la IA a hacer tu gráfico mensual y quieres que mañana lo repita igual. ¿Qué tiene que quedar guardado?

Le has enseñado a la IA a hacer tu gráfico mensual y quieres que mañana lo repita igual. ¿Qué tiene que quedar guardado?

Glosario · toca para ampliar

  • Skill

    Una habilidad guardada de la IA: un archivo en lenguaje natural que recoge cómo hacer una tarea que ya salió bien, para replicarla en cualquier sesión futura y con cualquier herramienta.

    Ver en el diccionario
  • Markdown

    El formato de texto plano en el que se escriben las skills. Un archivo que se lee como un documento normal, sin programar nada: por eso puedes abrirlo y corregirlo tú mismo.

    Ver en el diccionario
  • CLI

    Interfaz de línea de comandos: dar órdenes al ordenador escribiéndolas en vez de señalarlas con el ratón. Los agentes de IA como OpenCode o Claude Code son CLIs.

    Ver en el diccionario
  • Terminal

    La ventana de texto que habla directamente con tu sistema. Warp es una terminal moderna pensada para que la use alguien no técnico sin sentirse en una película de hackers.

    Ver en el diccionario
  • Directorio

    El nombre técnico de una carpeta. En la terminal te mueves entre directorios con cd, creas uno nuevo con mkdir y miras qué hay dentro con ls.

    Ver en el diccionario
  • Contexto

    Todo lo que la IA tiene delante mientras trabaja: tus archivos, la conversación y sus habilidades. Cuanto más ocupa, más caro sale cada mensaje; por eso conviene podar las skills de vez en cuando.

    Ver en el diccionario
  • Repositorio

    La copia de tu proyecto guardada en un servicio como GitHub, con todo su historial de cambios. Si es privado, solo lo ves tú; si lo pones público, cualquiera puede leerlo.

    Ver en el diccionario
  • Commit

    Guardar una foto del estado del proyecto con un mensaje que explica qué cambió. Es el paso previo al push, que es el que lo empuja a GitHub.

    Ver en el diccionario
  • Transcripción

    Pasar audio a texto. No es perfecta, pero acierta lo suficiente como para que otra IA trabaje encima: resumir la reunión, sacar los acuerdos o montar la página de una clase.

    Ver en el diccionario

Si solo tienes tiempo para 2 cosas

Estas dos ideas son las que más impacto tienen. Si te llevaras únicamente dos cosas de toda esta página, que sean éstas:

  1. Cierra el bucle o no aprende: corregir a la IA no basta. Hay que decirle "incorpora esta corrección a tu habilidad". Ese es el gesto que convierte un acierto suelto en una skill que funciona sola mañana.
  2. Una carpeta por proyecto, siempre: crea la carpeta antes de empezar y lanza el agente dentro. La carpeta es el contexto y persiste; la sesión va y viene. Con eso puedes cerrar el ordenador tranquilo y retomarlo mañana.

¿Quieres que montemos tu flujo juntos? Puedes reservar una mentoría conmigo o escribirme a hi@alci.dev. El siguiente capítulo de esta historia es entrenar una skill sobre la tarea que más te repites cada semana.

Alcibiades Cabral · Skills que se quedan y la terminal sin miedo
Píldora de mentoría · 24 julio 2026