CommunityProgramación y desarrollogithub.com

ranupaners-arch/dars-kit

Construye lecciones listas para enseñar de árabe moderno estándar para aprendices no nativos a partir de un tema y nivel: vocabulario completamente vocalizado (mufradat) con plural, género y formas verbales, un diálogo (hiwar), un punto gramatical (qawa'id), ejercicios que abarcan las cuatro habilidades (maharat), una clave de respuestas separada con rúbricas, notas del profesor con tiempos y un esquema opcional de diapositivas o modulo ajar.

¿Qué es dars-kit?

Dars Kit es una habilidad de agente de IA para construir lecciones completas y listas para enseñar de árabe moderno estándar (MSA) dirigidas a estudiantes no nativos, especialmente en contextos de madrasah o pesantren en Indonesia. La habilidad toma un tema (por ejemplo, 'la casa', 'la familia') y un nivel (principiante, intermedio o avanzado) como entrada, y produce vocabulario totalmente vocalizado con plurales, género y formas verbales, un diálogo original, un punto gramatical, ejercicios que cubren al menos dos de las cuatro habilidades (escuchar, hablar, leer, escribir) y una clave de respuestas separada con rúbricas. También incluye notas del profesor con tiempos de clase y puede generar un esquema de diapositivas o un módulo de enseñanza (modul ajar) si se solicita. La habilidad utiliza una plantilla estructurada y sigue reglas estrictas: siempre usa MSA por defecto, escribe nueva original (no reproduce libros de texto publicados), y aplica vocalización completa para niveles principiante e intermedio. Está diseñada para ser usada con asistentes de codificación como Claude Code, Cursor o Codex, y se apoya en varios archivos de referencia para precisión en árabe, diseño pedagógico y evaluación.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ranupaners-arch/dars-kit/tree/HEAD

Installed? Explore more Programación y desarrollo skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Preguntar en tu IA favorita

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

Documentación

Dars Kit

Convierte un tema (السَّكَنُ, الْأُسْرَةُ, الْمَدْرَسَةُ, ...) en una lección de árabe lista para el aula para estudiantes indonesios en madrasah, pesantren o clases generales.

1. Entradas y valores predeterminados

Pregunta solo por lo que falte. Si el profesor da solo un tema, continúa con los valores predeterminados y enumera los supuestos al inicio de la respuesta.

EntradaValor predeterminadoNotas
Tema (مَوْضُوعٌ)requeridoÁrabe o indonesio
Nivelprincipiante (مُبْتَدِئٌ)intermedio (مُتَوَسِّطٌ), avanzado (مُتَقَدِّمٌ); consulta references/pedagogy.md para orientación aproximada de CEFR/ACTFL
Idioma de explicaciónIndonesioInglés u otros a petición
Modo de salidalección completasolo vocabulario, solo ejercicios, esquema de diapositivas, modul ajar
Duración de la clase90 minutos (2 × 45)los tiempos en las notas del profesor deben sumar esto
Estudiantesno especificadoedad, fase/kelas, madrasah/pesantren/umum, mixto o de un solo género
Alineación curricularningunasi el profesor solicita alineación con madrasah, sigue references/pedagogy.md §Curriculum

2. Reglas no negociables

  1. MSA (الْفُصْحَى) por defecto; dialecto solo si el profesor lo solicita.
  2. Harakat según el nivel: principiante e intermedio reciben harakat completo en cada palabra árabe en vocabulario, diálogo, ejemplos y ejercicios, incluidos i'rab y tanwin; avanzado recibe harakat solo en palabras ambiguas o recién introducidas.
  3. Sustantivos: singular, plural y género, p. ej. بَيْتٌ ج بُيُوتٌ (مُذَكَّرٌ). Verbos: pasado, presente y masdar, p. ej. كَتَبَ – يَكْتُبُ – كِتَابَةٌ.
  4. Dirección: el árabe y su traducción nunca comparten una línea. Usa celdas de tabla separadas o líneas separadas. Las instrucciones y el diálogo nunca tienen escritura mixta. Las explicaciones (gramática, razones clave, notas) pueden citar un término árabe corto de una o dos palabras dentro de una oración en el idioma de explicación.
  5. Concordancia: los pronombres y las formas verbales coinciden con cada hablante (أَنْتَ / أَنْتِ, هُوَ / هِيَ). Los hablantes del diálogo son del mismo género a menos que el profesor indique lo contrario.
  6. Habilidades: los ejercicios cubren al menos dos de las cuatro maharat (اِسْتِمَاعٌ، كَلَامٌ، قِرَاءَةٌ، كِتَابَةٌ).
  7. Clave de respuestas es una sección separada después de todo el material del estudiante y nunca está en las diapositivas del estudiante.
  8. Originalidad: escribe diálogos, textos y elementos nuevos. No reproduzcas libros de texto publicados, ni siquiera parcialmente; úsalos solo como modelos estructurales.
  9. Incertidumbre: si no estás seguro sobre una vocalización, plural, género, masdar o significado, márcalo con ⚠️ y una razón breve en lugar de adivinar.
  10. Notas del orador y notas del profesor están escritas en el idioma de explicación.

3. Flujo de trabajo

Copia esta lista de verificación en tus notas de trabajo y márcala:

- [ ] 1. Entradas confirmadas, valores predeterminados indicados
- [ ] 2. Plan de lección: objetivos → palabras objetivo → un punto gramatical → habilidades
- [ ] 3. Borrador con assets/lesson-template.md
- [ ] 4. Árabe verificado según references/arabic-text-rules.md
- [ ] 5. Ejercicios, clave y rúbrica verificados según references/assessment.md
- [ ] 6. Diapositivas (si se solicitan) según references/slide-design.md
- [ ] 7. Bucle de autoverificación superado (sección 5)
- [ ] 8. Entregado con supuestos y lista ⚠️

Paso 1 – Entradas. Aplica la sección 1. No hagas más de una ronda de preguntas.

Paso 2 – Planificar hacia atrás desde los objetivos. Escribe 2–3 objetivos medibles (verbo observable + cantidad + habilidad, p. ej. "Siswa mampu menyebutkan 10 nama ruangan rumah dengan harakat yang benar"). Elige palabras objetivo que sirvan a los objetivos, luego un punto gramatical que ocurra naturalmente en el diálogo, luego las habilidades que evaluará cada ejercicio. Cada objetivo debe ser verificado por al menos un ejercicio.

Paso 3 – Borrador. Completa assets/lesson-template.md en orden. Tamaños según el nivel:

PrincipianteIntermedioAvanzado
Palabras nuevas10–1515–2020–25
Diálogo / texto6–10 líneas cortas8–12 líneas o un texto cortotexto o diálogo más largo
Transliteraciónsí, un esquema consistentenono
Tipos de ejercicio3–54–64–6, incluye una tarea HOTS

Las palabras de apoyo que no sean vocabulario objetivo pueden aparecer en el diálogo solo si son muy comunes o claras por el contexto. Enumérelas bajo "ungkapan pendukung".

Paso 4 – Precisión del árabe. Lee references/arabic-text-rules.md antes de escribir árabe por primera vez en una sesión. Presta especial atención a las formas de hamza, marcación lam shamsiyya/qamariyya, diptotos (مَمْنُوعٌ مِنَ الصَّرْفِ), y letras Unicode (árabe ي y ك, nunca persa ی o ک).

Paso 5 – Ejercicios y clave. Lee references/assessment.md. Usa opción múltiple de 3 opciones con distractores plausibles, asigna a cada ejercicio su maharah y nivel cognitivo, y adjunta una rúbrica analítica a cada tarea de habla o escritura.

Paso 6 – Diapositivas (solo si se solicitan). Lee references/slide-design.md y usa el formato de bloque de diapositivas allí.

Paso 7 – Bucle de autoverificación. Ejecuta la lista de verificación de la sección 5. Si hay acceso al shell, también ejecuta:

python3 scripts/check_arabic.py <output.md> --level beginner

El script reporta errores Unicode (letras persas, tatweel, formas de presentación, ى mal colocado) y palabras no vocalizadas. Corrige cada error y vuelve a ejecutar hasta que esté limpio. Trata las advertencias como elementos a revisar, no como fallos automáticos.

Paso 8 – Entregar. Comienza con un resumen de 2–4 líneas: tema, nivel, duración, supuestos. Termina con la lista ⚠️ (o "Tidak ada item ⚠️").

4. Modos de salida

  • Lección completa: cada sección de assets/lesson-template.md.
  • Solo vocabulario: objetivos, tabla de vocabulario, 2–3 oraciones de ejemplo por verbo, un ejercicio rápido y su clave.
  • Solo ejercicios: los ejercicios, clave y rúbrica. Indica qué vocabulario y gramática asumen.
  • Esquema de diapositivas: el formato de bloque de diapositivas en references/slide-design.md, más un bloque de clave de respuestas separado para el profesor.
  • Modul ajar: envuelve la lección completa en los componentes de modul ajar enumerados en references/pedagogy.md §Modul ajar. No inventes nombres de políticas ni números de regulación. Usa solo los que están en ese archivo, y solo si el profesor solicita alineación.

5. Lista de verificación de calidad (ejecutar antes de responder)

Árabe

  • Harakat presente en la densidad del nivel, e i'rab coincide con el rol de cada palabra.
  • Cada plural, género y masdar es correcto o está marcado con ⚠️.
  • Hamzat qat' escrito (أ / إ), hamzat wasl desnudo (ا); lam qamariyya tiene sukun (الْ), lam shamsiyya ninguno y la siguiente letra tiene shadda (السَّ).
  • Los diptotos no llevan tanwin (مَطَابِخُ، أَحْمَدُ).
  • Solo letras del bloque árabe; sin tatweel, sin persa ی/ک, ى solo al final de la palabra.

Pedagogía

  • Cada objetivo es medible y evaluado por al menos un ejercicio.
  • Cada palabra objetivo aparece en el diálogo o ejercicios al menos una vez.
  • Al menos dos maharat cubiertas; escuchar y hablar vienen antes que escribir para principiantes.
  • Los tiempos suman exactamente la duración de la clase.

Evaluación

  • Cada elemento tiene exactamente una respuesta correcta. Para elementos abiertos o de reordenamiento, la clave enumera todas las variantes aceptadas.
  • La numeración de la clave coincide uno a uno con los elementos.
  • Los distractores son plausibles y homogéneos, y la posición de la opción correcta varía.
  • Las tareas de habla y escritura tienen una rúbrica.

Formato

  • Las instrucciones y el diálogo son de una sola escritura; el árabe y la traducción están en líneas o celdas separadas.
  • La clave de respuestas está separada, y las diapositivas del estudiante no contienen respuestas.
  • Las notas del profesor y del orador están en el idioma de explicación.

6. Archivos de referencia (leer cuando sea necesario)

  • references/pedagogy.md: maharat y unsur lughah, flujo de la lección, orientación de nivel, alineación del plan de estudios de Indonesia, componentes de modul ajar.
  • references/arabic-text-rules.md: harakat, notación morfológica, ortografía y verificaciones Unicode, errores comunes de los estudiantes.
  • references/assessment.md: tipos de ejercicio por maharah, reglas de redacción de ítems, diseño de distractores, HOTS, rúbricas, formato de clave de respuestas.
  • references/slide-design.md: fuentes y licencias, tamaños, diseño RTL, formato de bloque de diapositivas.
  • assets/lesson-template.md: esqueleto de salida exacto.
  • examples/sakan-pemula.md: ejemplo resuelto (السَّكَنُ, principiante, 2 × 45 min).
  • scripts/check_arabic.py: verificador de Unicode y vocalización (Python 3, sin dependencias).

Skills relacionados