Saltar a contenido

La skill moodle-course-design

local_mcp incluye dos Agent Skills junto al plugin, para que un cliente que carga skills siga los mismos pasos sin adivinar:

  • skills/moodle-course-design/SKILL.md: diseñar y construir un curso.
  • skills/moodle-grading/SKILL.md: leer una entrega y proponer una nota. Consulta Calificar con dryRun.

Los clientes que no cargan skills reciben el mismo texto con los prompts MCP design_course y create_quiz_from_content.

Instalarla en un cliente

Copia la carpeta moodle-course-design del plugin (local/mcp/skills/) a la carpeta de skills de tu cliente, por ejemplo ~/.cursor/skills/ o ~/.claude/skills/. La skill solo explica cómo usar las tools; necesita una conexión MCP al sitio que funcione.

Qué le dice al agente

Orden de trabajo

  1. list_categories y elegir una fila con canCreate a true. Si coinciden varios nombres, preguntar qué id usar.
  2. Planificar el curso y crearlo: de una vez con build_course (primero dryRun: true, luego dryRun: false, y consultar get_task_status), o paso a paso con create_course, add_section, add_activity o create_quiz.
  3. Añadir las secciones antes que las actividades que van en ellas. La sección 0 es la general.
  4. Añadir actividades. En un cuestionario, las preguntas van en la misma llamada o con add_quiz_questions o import_questions.
  5. Revisar el curso con get_course_structure antes de cambiar la visibilidad.
  6. set_visibility para el curso o actividades sueltas.
  7. Cuentas, matriculación y grupos al final: search_users, create_user (alcance admin), enrol_user, set_user_role, create_group, add_group_members. Con dryRun: true se comprueba sin guardar.

Cómo es un buen curso

  • Una sección por semana o tema, con un nombre que diga qué sabrá hacer el estudiante.
  • Primero la explicación breve (página o etiqueta) y después lo que hace el estudiante (tarea, foro o cuestionario).
  • Actividades con nombres pensados para el estudiante («Entrega las notas de campo»), no para el editor («Página 3»).
  • Una tarea tiene fechas de apertura, entrega y límite, y una rúbrica con al menos dos niveles antes de matricular a nadie.
  • Un cuestionario va después de la página que enseña la idea, es corto y dice cuándo se puede revisar.
  • El curso sigue oculto hasta que get_course_structure coincide con el plan.

Reglas

  • Usar solo ids que acaba de devolver una tool. No inventar ids de curso, categoría, sección ni módulo.
  • Identificar un curso con courseId o courseShortname, y una persona con userId, username o email: solo uno de cada.
  • Las fechas aceptan YYYY-MM-DD, una fecha ISO 8601 con desfase o una marca de tiempo Unix.
  • Un campo que no corresponde al tipo de actividad es un error; la skill incluye la tabla de campos por tipo.
  • Tipos de pregunta: multichoice, truefalse, shortanswer, numerical, match, essay. import_questions acepta GIFT o Moodle XML.

Cuestionario a partir de contenido. Leer la fuente, enseñar las preguntas propuestas (enunciado, respuestas, retroalimentación, dificultad) y esperar. Después create_quiz con dryRun: true y, solo tras la confirmación, create_quiz y add_quiz_questions.

La skill recoge también los errores frecuentes (categoría equivocada, un campo de otro tipo, escritura desactivada, borrados que necesitan dryRun: false y confirm: true) y qué hacer con cada uno.