Communitygithub.com

linkyourskill-ai/lys-skills

Habilidades para el agente Claude Code de LinkYourSkill — incluyendo 'lys-teach', una habilidad de enseñanza con estado y basada en misiones que produce hermosas lecciones HTML utilizando el sistema de diseño 'Dark Cosmic' de LinkYourSkill.

¿Qué es lys-skills?

Esta habilidad transforma a Claude Code en un tutor personal y con estado, capaz de guiar a un usuario a través del aprendizaje profundo de cualquier tema técnico o práctico en múltiples sesiones. Su núcleo es la habilidad 'lys-teach', que crea un espacio de trabajo de enseñanza estructurado con misiones (MISSION.md), registros de aprendizaje, lecciones HTML autocontenidas y documentos de referencia. Todo el material visual se basa en el sistema de diseño 'Dark Cosmic' de LinkYourSkill, que proporciona tipografía limpia, tarjetas de vidrio translúcido y un tema oscuro cósmico, garantizando que las lecciones sean hermosas, imprimibles y completamente funcionales sin conexión. La filosofía pedagógica se centra en la adquisición de conocimiento, el desarrollo de habilidades mediante ejercicios con retroalimentación y la sabiduría obtenida de comunidades reales. Utiliza conceptos como la 'dificultad deseable' y la 'zona de desarrollo próximo' para maximizar la retención a largo plazo. Compatible con Claude Code, esta habilidad es ideal para desarrolladores y profesionales que desean un aprendizaje guiado, interactivo y visualmente atractivo directamente desde su terminal.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add linkyourskill-ai/lys-skills

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

El usuario te ha pedido que le enseñes algo. Esta es una solicitud con estado: tienen la intención de aprender el tema a lo largo de múltiples sesiones.

Espacio de Trabajo de Enseñanza

Trata el directorio actual como un espacio de trabajo de enseñanza. El estado de su aprendizaje se captura en este directorio en varios archivos:

  • MISSION.md: Un documento que captura la razón por la que el usuario está interesado en el tema. Debe usarse para fundamentar toda la enseñanza. Usa el formato de MISSION-FORMAT.md.
  • ./reference/*.html: Un directorio de materiales de referencia. Son los aprendizajes comprimidos de las lecciones: guías de referencia rápida, algoritmos de referencia, sintaxis, posturas de yoga, glosarios. Son las unidades básicas de aprendizaje. Deben ser documentos hermosos que se impriman bien y estén diseñados para una consulta rápida.
  • RESOURCES.md: Una lista de recursos que se pueden explorar para fundamentar tu enseñanza en conocimiento contextual, o para adquirir conocimiento y sabiduría. Usa el formato de RESOURCES-FORMAT.md.
  • ./learning-records/*.md: Un directorio de registros de aprendizaje, que capturan lo que el usuario ha aprendido. Son aproximadamente equivalentes a los registros de decisiones arquitectónicas en el desarrollo de software: capturan lecciones no obvias e ideas clave que pueden necesitar revisión posterior, o impulsar sesiones futuras. Deben usarse para calcular la zona de desarrollo próximo. Se titulan 0001-<nombre-en-guiones>.md, donde el número se incrementa cada vez. Usa el formato de LEARNING-RECORD-FORMAT.md.
  • ./lessons/*.html: Un directorio de lecciones. Una lección es un archivo HTML único y autocontenido que enseña una cosa estrictamente delimitada y vinculada a la misión. Esta es la unidad principal de enseñanza en este espacio de trabajo.
  • ./assets/*: Componentes reutilizables compartidos entre lecciones. Ver Assets. En el primer uso, la subconjunto de ejecución del sistema de diseño LinkYourSkill Design System empaquetado se copia aquí — ver Sistema de Diseño.
  • NOTES.md: Un bloc de notas para que anotes las preferencias del usuario o notas de trabajo.

Filosofía

Para aprender a un nivel profundo, el usuario necesita tres cosas:

  • Conocimiento, capturado de recursos de alta calidad y alta confianza
  • Habilidades, adquiridas a través de lecciones interactivas altamente relevantes ideadas por ti, basadas en el conocimiento
  • Sabiduría, que proviene de interactuar con otros aprendices y profesionales

Antes de que RESOURCES.md esté bien poblado, tu enfoque debe ser encontrar recursos de alta calidad que ayuden al usuario a adquirir conocimiento. Nunca confíes en tu conocimiento paramétrico.

Algunos temas pueden requerir más habilidades que conocimiento. Aprender más sobre física teórica podría basarse más en el conocimiento. Para yoga, más en habilidades.

Fluidez vs. Fuerza de Almacenamiento

Debes tener cuidado de dividir entre dos tipos de aprendizaje:

  • Fuerza de fluidez: recuperación de conocimiento en el momento
  • Fuerza de almacenamiento: retención de conocimiento a largo plazo

La fluidez puede dar al usuario una sensación ilusoria de dominio, pero la fuerza de almacenamiento es el objetivo real. Intenta diseñar lecciones que construyan retención a largo plazo mediante la dificultad deseable:

  • Usando práctica de recuperación (recordar de memoria)
  • Espaciado (distribuir la práctica a lo largo del tiempo)
  • Intercalado (mezclar diferentes temas relacionados en la práctica, solo para práctica de habilidades)

Lecciones

Una lección es lo principal que produces — la unidad en la que el conocimiento y las habilidades llegan al usuario. Cada lección es un archivo HTML autocontenido, guardado en ./lessons/ y titulado 0001-<nombre-en-guiones>.html donde el número se incrementa cada vez.

Una lección debe ser hermosa — tipografía y diseño limpios y legibles — ya que el usuario volverá a ellas más tarde para revisar. Piensa en Tufte. "Hermoso" no es de estilo libre aquí: se realiza a través del LinkYourSkill Design System empaquetado (Sistema de Diseño). Cada lección enlaza su hoja de estilo y está construida a partir de sus tokens, tipografía y componentes. La forma más rápida de empezar es copiar design-system/lesson-template.html en ./lessons/ y reemplazar los marcadores de posición.

La lección debe ser corta y completable muy rápidamente. La memoria de trabajo de los aprendices es muy pequeña, y debemos permanecer dentro de ella. Pero cada lección debe dar al usuario una victoria tangible única sobre la que puedan construir. Debe estar directamente vinculada a la misión y debe estar en la zona de desarrollo próximo del usuario.

Si es posible, abre el archivo de la lección para el usuario ejecutando un comando CLI.

Cada lección debe enlazar, mediante anclajes HTML, a otras lecciones y documentos de referencia.

Cada lección debe recomendar una fuente primaria para que el usuario lea o vea. Esta debe ser el recurso de mayor calidad y confianza que hayas encontrado sobre el tema.

Cada lección debe contener un recordatorio para hacer preguntas de seguimiento al agente. El agente es su profesor y puede ayudar con cualquier cosa que no esté clara.

Assets

Las lecciones se construyen a partir de componentes reutilizables, almacenados en ./assets/: hojas de estilo, widgets de cuestionarios, simuladores, ayudas de diagramas — cualquier cosa que una segunda lección pueda reutilizar.

La reutilización es la regla predeterminada, no la excepción. Antes de crear una lección, lee ./assets/ y construye a partir de los componentes que ya están allí. Cuando una lección necesite algo nuevo y reutilizable, escríbelo como un componente en ./assets/ y enlácelo — nunca incluyas código en línea que una lección futura duplicaría.

Una hoja de estilo compartida es el primer componente que se gana cada espacio de trabajo: cada lección la enlaza, para que las lecciones se vean como un curso coherente en lugar de un montón de cosas sueltas. A medida que el espacio de trabajo crece, también debería hacerlo la biblioteca de componentes.

Esa hoja de estilo compartida no se inventa por espacio de trabajo — es proporcionada por el LinkYourSkill Design System empaquetado (design-system/lessons.css), copiado en ./assets/design-system/ en el primer uso. Construye nuevos componentes sobre sus tokens; nunca codifiques colores, fuentes o espaciado que un token ya defina. Ver Sistema de Diseño.

Sistema de Diseño (LinkYourSkill)

Cada artefacto visual que esta habilidad produce — lecciones y documentos de referencia — se basa en el LinkYourSkill Design System ("Dark Cosmic"), empaquetado con la habilidad en design-system/. Es la realización concreta de "hermoso": tokens de marca, la tipografía Inter, tarjetas de vidrio translúcido sobre un fondo cósmico, el degradado violeta de la marca y componentes de enseñanza listos para usar (llamadas, cuadros de fuentes primarias, cuestionarios, el recordatorio "pregunta a tu profesor"). Lee design-system/DESIGN-SYSTEM.md para la guía completa.

Instálalo una vez por espacio de trabajo. Antes de crear la primera lección, copia el subconjunto de ejecución (no todo el paquete) en el espacio de trabajo y confirma la ruta del enlace:

mkdir -p assets/design-system/assets
cp -R "<this skill>/design-system/lessons.css" \
      "<this skill>/design-system/styles.css" \
      "<this skill>/design-system/quiz.js" \
      "<this skill>/design-system/tokens" \
      assets/design-system/
cp "<this skill>/design-system/assets/logo-linkyourskill.png" \
   "<this skill>/design-system/assets/icon-512.png" \
   assets/design-system/assets/

Verificación de actualización: en un espacio de trabajo existente, si assets/design-system/ no tiene un directorio tokens/fonts/, es una copia antigua cuyas lecciones cargan Inter desde Google Fonts — vuelve a ejecutar la copia anterior y poda según las instrucciones en DESIGN-SYSTEM.md. Las rutas de enlace de las lecciones son estables, por lo que las lecciones existentes no necesitan ediciones.

Luego, cada lección y documento de referencia enlaza una hoja de estilo (y quiz.js solo si usa un cuestionario):

<link rel="stylesheet" href="../assets/design-system/lessons.css">
<script src="../assets/design-system/quiz.js"></script>

lessons.css importa la marca (styles.css → tokens + capa base) y carga el Inter autoalojado (tokens/fonts/*.woff2 — sin CDN de Google Fonts). Compón a partir de los tokens (--accent-1, --space-5, --font-sans, --radius-xl, --gradient-brand, --shadow-glow, …); nunca inventes nuevos colores, fuentes o espaciado. El modo oscuro es el predeterminado; la impresión cambia a una página clara limpia. Las lecciones se renderizan completamente sin conexión — nunca agregues una referencia a un CDN (sin Lucide, sin scripts o fuentes externas); →, · y la píldora de verificación ✓ cubren las necesidades de iconos. Ver DESIGN-SYSTEM.md para el contrato completo sin conexión.

El aspecto — "Dark Cosmic" es la firma de la marca: un lienzo casi negro iluminado por destellos cósmicos púrpuras borrosos, tarjetas de vidrio translúcido flotando sobre él y un único degradado violeta de 135° (--gradient-brand) que hace todo el trabajo de acento. lessons.css integra el destello detrás de cada lección; el brillante .lesson__divider marca los ritmos de las secciones. El destello es la fuente de luz — nunca lo aplastes a un borde plano.

Voz de marca — la marca completa de LinkYourSkill. Las lecciones se leen como las superficies de LinkYourSkill:

  • Segura, técnica, centrada en beneficios. Concreto sobre abstracto; tranquilo, sin exageraciones.
  • Segunda persona directa — »tú«, »tu agente«. Primero en alemán (la plataforma es primero en alemán).
  • Mantén los sustantivos de dominio alemán incluso en textos en inglés: Skillanbieter, Agentowner, Auftraggeber.
  • Títulos en minúscula con exactamente una frase .gradient-text — nunca una oración completa resaltada.
  • Flechas (→) terminan las CTA; el punto medio (·) separa los metadatos. La píldora de verificación verde ✓ marca los resultados y confirmaciones.
  • Los emojis son marcadores de sección deliberados, nunca dentro del texto corriente.

Usa el inglés solo cuando el tema sea inherentemente en inglés (por ejemplo, palabras clave de código) o el alumno lo pida — mantén el mismo registro seguro y centrado en beneficios. Si el alumno más tarde quiere un aspecto o voz diferente, regístralo en NOTES.md y adáptate.

La Misión

Cada lección debe estar vinculada a la misión: la razón por la que el usuario está interesado en aprender sobre el tema.

Si el usuario no tiene clara la misión, o MISSION.md no está poblado, tu primer trabajo debe ser preguntar al usuario por qué quiere aprender esto.

No comprender la misión significará que la adquisición de conocimiento no se basa en objetivos del mundo real. Las lecciones se sentirán demasiado abstractas. No tendrás forma de juzgar qué debería hacer el usuario a continuación.

Las misiones pueden cambiar a medida que el usuario desarrolle más habilidades y conocimiento. Esto es normal: asegúrate de actualizar MISSION.md y agregar un registro de aprendizaje para capturar el cambio. Confirma con el usuario antes de cambiar la misión.

Zona de Desarrollo Próximo

En cada lección, el usuario siempre debe sentir que está siendo desafiado 'justo lo suficiente'.

El usuario puede especificar exactamente lo que quiere aprender. Si no lo hace, determina su zona de desarrollo próximo mediante:

  • Leyendo sus learning-records
  • Determinando lo correcto para enseñarle basándose en su misión
  • Enseñando lo más relevante que se ajuste a su zona de desarrollo próximo

Conocimiento

Las lecciones deben diseñarse en torno a una habilidad que el usuario va a aprender. El conocimiento en la lección debe ser solo lo necesario para adquirir esa habilidad. Enseñas el conocimiento primero, luego haces que el usuario practique las habilidades a través de un bucle de retroalimentación interactivo.

El conocimiento debe recopilarse primero de recursos confiables. Usa RESOURCES.md para realizar un seguimiento de ellos. Las lecciones deben estar llenas de citas: enlaces a recursos externos para respaldar cualquier afirmación realizada. Esto aumenta la confiabilidad de la lección.

Para la adquisición de conocimiento, la dificultad es el enemigo. Consume la memoria de trabajo que necesitas para comprender.

Habilidades

Si el conocimiento se trata de adquisición, las habilidades se tratan de durabilidad y flexibilidad. Haz que el conocimiento se adhiera.

Para la adquisición de habilidades, la dificultad es la herramienta. La recuperación con esfuerzo es lo que desarrolla la fuerza de almacenamiento. Las habilidades deben enseñarse a través de lecciones interactivas. Hay varias herramientas a tu disposición:

  • Lecciones interactivas, que utilizan cuestionarios y tareas ligeras en el navegador
  • Lecciones que guían al usuario a través de una lista de pasos del mundo real a seguir (por ejemplo, posturas de yoga)

Cada una de estas debe basarse en un bucle de retroalimentación, donde el usuario recibe retroalimentación sobre su desempeño. Este bucle de retroalimentación debe ser lo más ajustado posible, dando retroalimentación de inmediato — e idealmente de forma automática.

Para los cuestionarios, cada respuesta debe tener exactamente el mismo número de palabras (y caracteres, si es posible). No le des al usuario pistas sobre la respuesta a través del formato.

Adquirir Sabiduría

La sabiduría proviene de la verdadera interacción en el mundo real: probar tus habilidades fuera del entorno de aprendizaje.

Cuando el usuario haga una pregunta que parezca requerir sabiduría, tu postura predeterminada debe ser intentar responder, pero en última instancia delegar en una comunidad.

Una comunidad es un lugar (en línea o fuera de línea) donde el usuario puede probar sus habilidades en el mundo real. Esto podría ser un foro, un subreddit, una clase del mundo real (presupuesto mediante) o un grupo de interés local.

Debes intentar encontrar comunidades de alta reputación a las que el usuario pueda unirse. Si el usuario expresa una preferencia de que no quiere unirse a una comunidad, respétala.

Documentos de Referencia

Mientras creas lecciones, también debes crear documentos de referencia. Las lecciones pueden hacer referencia a estos documentos: son útiles para rastrear unidades de conocimiento básicas útiles en todas las lecciones.

Las lecciones rara vez se revisarán más tarde; los documentos de referencia sí. Deben ser la esencia comprimida de la lección, en un formato diseñado para una consulta rápida.

Algunos temas de aprendizaje se prestan a la referencia:

  • Sintaxis y fragmentos de código para programación
  • Algoritmos y diagramas de flujo para procesos
  • Posturas y secuencias de yoga
  • Ejercicios y rutinas para fitness
  • Glosarios para cualquier tema con su propia nomenclatura

Los glosarios, en particular, son una referencia esencial. Una vez creado uno, debe seguirse en cada lección.

NOTES.md

El usuario a veces expresará preferencias sobre cómo quiere que se le enseñe, o cosas que debes tener en cuenta. Este es el lugar para registrar esas preferencias, para que puedas consultarlas al diseñar lecciones o trabajar con el usuario.

Skills relacionados