AI Skills for Real Educators 🍎

Un sistema de habilidades cognitivas y pedagógicas reutilizables para enseñar, aprender y desarrollar pensamiento crítico con IA.

Este repositorio está inspirado en el trabajo de Matt Pocock, pero trasladado del ámbito de la ingeniería de software al ámbito de la innovación educativa y las humanidades.

La Filosofía: Producir Conocimiento, no solo Código

La mayoría de las interacciones con la IA hoy en día son transaccionales: "hazme esto", "resúmeme aquello". AI Edu-Skills cambia el paradigma. Aquí, la IA no es una herramienta de producción, sino un tutor cognitivo que guía procesos de aprendizaje profundo.

Las skills no se organizan por contenidos (Filosofía, Historia, Biología), sino por procesos cognitivos transferibles. Un alumno de Medicina y uno de Derecho necesitan, en el fondo, las mismas habilidades: comprender, memorizar, argumentar e investigar.

Taxonomía Edu-Skills

El sistema se organiza en 6 grandes familias de procesos:

1. Learn Skills 🧠

Para la comprensión profunda y la construcción de conceptos.

• /socratic-tutor: Aprender mediante preguntas.
• /concept-builder: Construcción progresiva.
• /analogy-generator: Aprender mediante analogías.
• /first-principles: Descomposición conceptual.

2. Critical Thinking Skills ⚖️

Para el análisis riguroso y la detección de sesgos.

• /argument-debugger: Linter de lógica y falacias.
• /steelman-builder: Reconstrucción de la mejor versión de una postura.
• /dialectical-thinking: Tesis, objeción y síntesis.
• /assumption-hunter: Búsqueda de presupuestos invisibles.

3. Memory Skills 🏛️

Para la retención a largo plazo.

• /mnemonic-builder: Acrónimos, historias e imágenes.
• /spaced-review: Generación de repasos espaciados.
• /active-recall: Recuperación activa de información.
• /memory-palace: Construcción de recorridos espaciales.

4. Learning By Doing (LBD) Skills 🛠️

Para el aprendizaje activo mediante la creación.

• /essay-writer: Tutor editorial para ensayos.
• /teach-back: La técnica Feynman (explicar para aprender).
• /debate-simulator: Simulación de posturas opuestas.
• /project-builder: Descomposición de proyectos en entregables.

5. Research Skills 🔍

Para la investigación y gestión del conocimiento.

• /source-critic: Evaluación de fuentes.
• /ontology-builder: Extracción de grafos de conocimiento.
• /synthesis-engine: Integración de múltiples fuentes.

6. Educator Skills 🎓

Específicamente para docentes y diseñadores instruccionales.

• /misconception-detector: Detección de errores frecuentes.
• /rubric-builder: Construcción de criterios de evaluación.
• /curriculum-designer: Diseño de programas alineados.

La Skill Maestra: Learning Loop ♻️

Si quieres experimentar el sistema completo, usa /learning-loop [tema]. Esta skill orquestará un ciclo pedagógico completo:

1. Diagnóstico de conocimientos previos.
2. Comprensión del concepto.
3. Práctica aplicada.
4. Reflexión sobre el proceso.
5. Enseñanza (Teach-back).
6. Dominio (Mastery).

🏛️ CLI: Musa

Herramienta de línea de comandos para gestionar tus habilidades pedagógicas. Funciona en Windows, macOS y Linux.

Requisitos

• Node.js v18 o superior

Instalación global (recomendada)

npm install -g musa-cli

Una vez instalado, el comando musa estará disponible desde cualquier directorio.

Instalación desde el código fuente

git clone https://github.com/jpviola/eduSkills.git
cd eduSkills
npm install
npm install -g .

Primeros pasos

# 1. Configura tu proveedor de IA (se guarda en ~/.musa/config.json)
musa config

# 2. Explora las habilidades disponibles
musa list

# 3. Lee los detalles de una habilidad
musa explain socratic-tutor

# 4. Inicia una sesión de aprendizaje interactiva
musa chat socratic-tutor

Todos los comandos

| Comando | Descripción | |---------|-------------| | musa config | Configura tu proveedor de IA (OpenAI, Anthropic, Groq, Ollama) y API Key | | musa list | Lista todas las habilidades organizadas por proceso cognitivo | | musa explain <skill> | Muestra la filosofía e instrucciones de una habilidad | | musa chat <skill> | Inicia una sesión de aprendizaje interactiva en la terminal | | musa link | Enlaza las skills con Claude Desktop/CLI |

Cómo usar este repo

1. Copia y pega el contenido de una SKILL.md en tu sistema de instrucciones (System Prompt) o úsalo directamente en un chat con Claude/ChatGPT.
2. Adapta las instrucciones a tus necesidades específicas.
3. Contribuye creando nuevas skills que sigan esta filosofía pedagógica.

Desarrollado para Real Educators que buscan en la IA un aliado para la excelencia intelectual.