Repolode
ywEdAi

ywEdAi/teachable-figures

Una skill para agentes que convierte una afirmación de una lección en una figura interactiva donde los estudiantes predicen, cambian una causa y explican un caso nuevo.

Estrellas
283
Forks
38
Issues abiertos
0
Último commit
hace 4 días

¿Qué es?

Teachable figures es una skill para agentes que permite crear figuras didácticas interactivas en torno a una sola afirmación causal. El estudiante predice un resultado, cambia una causa con controles nativos, observa el efecto y luego explica un caso de transferencia. La skill parte de una especificación didáctica que define la afirmación, la idea errónea común, la causa, el efecto observable y el modelo subyacente de la realidad; solo entonces elige la geometría y el renderizador.

El repositorio incluye las instrucciones de la skill, kits de renderizado adaptados de dos skills upstream (Anatomy, para sólidos mecánicos y vistas 3D, e iso-figure, para SVG isométrico), seis lecciones de ejemplo completas que se ejecutan sin conexión como HTML independiente, y suites de pruebas para navegador y modelos. Funciona con el esquema de lecciones de una aplicación anfitriona o como figura HTML independiente, y se instala en los directorios de skills de Claude Code o Codex.

Los ejemplos abarcan relaciones de transmisión, secciones transversales de un cono, un tórax humano en 3D, un cohete en corte, el flujo de datos de la atención en Transformer y una túnica de la dinastía Ming. El proyecto señala que las figuras generadas son diseños didácticos que no se han evaluado con estudiantes.

Funciones clave

  • 01Convierte una afirmación didáctica en un ciclo interactivo de predecir, probar y explicar.
  • 02Incluye kits de renderizado para SVG 2D, SVG isométrico, cortes de mecanismos y vistas 3D giratorias.
  • 03Incluye seis lecciones HTML completas, disponibles sin conexión, con controles nativos, opción para restablecer y páginas bilingües.
  • 04Incluye suites de pruebas para modelos y navegadores, además de un script de auditoría de geometría 3D.
  • 05Se instala como skill en Claude Code o Codex, o funciona a partir de una figura HTML sencilla.

Casos de uso

  • Crear una demostración interactiva de física o mecánica que muestre cómo cambiar una entrada modifica un resultado.
  • Crear una figura didáctica HTML independiente para una lección sobre una idea errónea.
  • Añadir interacciones de predicción y explicación a una aplicación educativa web existente.
  • Explorar formas de visualizar para estudiantes modelos abstractos como la atención o los trenes de engranajes.

Inicio rápido

  1. 1

    Instálalo para Claude Code clonando el repositorio en tu directorio de skills

    git clone https://github.com/ywEdAi/teachable-figures.git ~/.claude/skills/teachable-figures
  2. 2

    Reinicia Claude Code, escribe /teachable-figures y describe una tarea de enseñanza

  3. 3

    Opcionalmente, instala las dependencias de desarrollo para ejecutar las comprobaciones

    npm ci

Antes de usarlo

  • La licencia no está especificada en los metadatos, por lo que las condiciones de reutilización no están claras.
  • Las figuras no se han evaluado con estudiantes, así que su eficacia didáctica no está demostrada.
  • Algunos ejemplos incluidos contienen recorridos de reproducción automática que deben desactivarse antes de integrarlos en una lección.
  • Las comprobaciones del navegador requieren tener Google Chrome instalado o disponer de una configuración de Chromium para Playwright.

En colecciones

Temas

Preguntas frecuentes

¿Qué es teachable-figures?
Una skill para agentes que convierte una afirmación de una lección en una figura interactiva donde los estudiantes predicen, cambian una causa y explican un caso nuevo. Teachable figures es una skill para agentes que permite crear figuras didácticas interactivas en torno a una sola afirmación causal. El estudiante predice un resultado, cambia una causa con controles nativos, observa el efecto y luego explica un caso de transferencia. La skill parte de una especificación didáctica que define la afirmación, la idea errónea común, la causa, el efecto observable y el modelo subyacente de la realidad; solo entonces elige la geometría y el renderizador.
¿teachable-figures es gratuito? ¿Qué licencia tiene?
teachable-figures no declara ninguna licencia. Su código es público, pero sin licencia no tienes permiso explícito para reutilizarlo; consulta al autor antes de depender de él.
¿teachable-figures sigue mantenido?
Mantenimiento activo. El último commit de teachable-figures fue el 3 nov 2026.
¿Para qué puedo usar teachable-figures?
Crear una demostración interactiva de física o mecánica que muestre cómo cambiar una entrada modifica un resultado. Crear una figura didáctica HTML independiente para una lección sobre una idea errónea. Añadir interacciones de predicción y explicación a una aplicación educativa web existente. Explorar formas de visualizar para estudiantes modelos abstractos como la atención o los trenes de engranajes.
¿Cómo se instala teachable-figures?
Instálalo para Claude Code clonando el repositorio en tu directorio de skills: git clone https://github.com/ywEdAi/teachable-figures.git ~/.claude/skills/teachable-figures Reinicia Claude Code, escribe /teachable-figures y describe una tarea de enseñanza Opcionalmente, instala las dependencias de desarrollo para ejecutar las comprobaciones: npm ci
¿Dónde consigo teachable-figures?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/ywEdAi/teachable-figures

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados