Anki Exam Forge

Construye mazos .apkg de Anki de alto rendimiento para preparación de exámenes en un ciclo cerrado de 4 etapas: análisis de frecuencia de exámenes pasados (PDF/imágenes/texto -> informe de frecuencia determinista + mazo), generación de .apkg multi-tipo con GUID estable (Básica/MCQ/Cloze + multimedia), suplemento incremental de diapositivas de clase (PPT/DOCX/PDF) sin duplicados, y escritura de mnemotecnias para tarjetas atascadas/leech.

¿Qué es Anki Exam Forge?

Anki Exam Forge es una habilidad de IA especializada en transformar exámenes pasados dispersos, PDFs escaneados y diapositivas de clase en un sistema de estudio Anki en evolución, sin duplicados, centrado en la recuperabilidad de la memoria y el retorno de inversión del examen. Ofrece dos rutas de ejecución: como MCP Tools (cuando se instala como plugin Antigravity o servidor MCP) o como CLI independiente (Python puro o Node.js wrapper), lo que permite flexibilidad en entornos de agente. El flujo de trabajo de 4 fases comienza con la ingestión y análisis de frecuencia de exámenes pasados, donde extrae texto e imágenes de PDFs, PPTX, DOCX y más, luego normaliza preguntas en elementos JSON estructurados con `concept_key` para fusionar variaciones de la misma pregunta. La segunda fase valida y empaqueta tarjetas en un archivo `.apkg` con GUIDs deterministas, priorizando por frecuencia de examen. La tercera fase añade suplementos incrementales de diapositivas de clase sin duplicar tarjetas existentes, utilizando un algoritmo de diff inteligente. La cuarta fase repara tarjetas atascadas (leech) aplicando mnemotecnias estructuradas sin pérdida de progreso. La habilidad incluye referencias detalladas como guías de diseño de tarjetas, presets por materia y un libro de jugadas de mnemotecnias.

Compatible con~Claude Code~Codex CLI~Cursor✓Antigravity
npx skills add https://github.com/nonuiucode/anki-exam-forge/tree/HEAD/skills/anki-exam-forge

Installed? Explore more Productividad y colaboración skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

Preguntar en tu IA favorita

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

Documentación

¿Qué hace Anki Exam Forge?

Convierte exámenes pasados dispersos, PDFs escaneados y diapositivas de clase en un sistema de estudio Anki .apkg en evolución, sin duplicados, construido alrededor de la recuperabilidad de la memoria y el ROI del examen.

Rutas de Ejecución Duales (MCP o CLI Independiente)

Usa la interfaz que esté disponible en tu entorno de agente:

  • MCP Tools (cuando se instala como plugin Antigravity o servidor MCP):

    1. anki_doctor — verifica la preparación de Python, SQLite, OOXML (.pptx/.docx) y extracción de PDF.
    2. anki_extract_source — extrae texto, notas del orador, páginas PNG renderizadas (para PDFs escaneados) e imágenes incrustadas de .pdf, .pptx, .docx, .md/.txt o carpetas de imágenes.
    3. anki_analyze_frequency — agrupa elementos de examen por concept_key canónico, cuenta las apariciones exactas de forma determinista, genera un informe de frecuencia en Markdown y produce un deck.json priorizado.
    4. anki_validate_deck — verifica presencia de pregunta/respuesta, sintaxis de cloze {{c1::...}}, opciones MCQ >= 2, card_id/guid únicos, y rutas de archivos multimedia.
    5. anki_build_apkg — compila deck.json en un .apkg con GUID determinista (ExamForge-Basic, ExamForge-MCQ, ExamForge-Cloze) ordenado por frecuencia de examen.
    6. anki_inspect_apkg — inspecciona un .apkg existente (prefiriendo collection.anki21), extrae multimedia empaquetada y filtra notas por etiqueta (leech), mazo, consulta o minLapses.
    7. anki_diff_supplement — compara tarjetas candidatas de diapositivas/clase contra un deck.json o .apkg existente, manteniendo intactos todos los GUID originales y añadiendo solo tarjetas genuinamente nuevas.
    8. anki_apply_mnemonics — escribe mnemotecnias estructuradas de técnica de memoria en las tarjetas coincidentes mientras mantiene los GUID originales para actualizaciones de Anki sin pérdida de progreso.
  • CLI Independiente (cuando se instala via --skill-only o se ejecuta sin MCP):

    • Python puro (funciona directamente desde la carpeta de la habilidad, cero requisitos pip para el flujo central .apkg/.pptx/.docx): python <directorio-de-habilidad-o-plugin>/engine/cli.py <doctor|extract|freq|validate|build|inspect|diff|mnemonic> ...
    • Wrapper Node.js (cuando se ejecuta desde el repositorio del plugin): node <directorio-del-plugin>/server/cli.mjs <doctor|extract|freq|validate|build|inspect|diff|mnemonic> ...

Flujo de Trabajo en Ciclo Cerrado de 4 Fases

Fase 1: Ingestión de Exámenes Pasados y Análisis de Frecuencia

  1. Ejecuta anki_doctor (o cli.py doctor) para confirmar la preparación de PDF/Python.
  2. Extrae fuentes en ventanas manejables: llama a anki_extract_source en PDFs de exámenes pasados (fromPage: 1, maxPages: 15..20, renderMode: "auto"). Para páginas escaneadas/con muchas imágenes, lee las imágenes pages/page_XXX.png generadas con tu capacidad de visión multimodal en lugar de depender únicamente del texto OCR escaso. Continúa con next_from_page hasta cubrir todos los exámenes.
  3. Normaliza cada pregunta de examen en elementos JSON estructurados que contengan:
    • concept_key: nombre de concepto canónico conciso para que preguntas redactadas de manera diferente que evalúan el mismo hecho subyacente se fusionen limpiamente (ej., "桡神经损伤临床表现", "胃食管反流病一线用药").
    • card_type: "basic" | "mcq" | "cloze".
    • front / stem / text, options (para mcq), back / answer, explanation, topic, source_years (ej., ["2021", "2023"]), y media (nombres de archivos de diagramas).
  4. Nunca cuentes frecuencias mentalmente: pasa el array/archivo de elementos extraídos a anki_analyze_frequency (elige subjectPreset: clinical-medicine, postgrad-exam, law-exam o general) para generar el informe de frecuencia en Markdown determinista y el deck.json priorizado.

Fase 2: Creación de Tarjetas, Validación y Empaquetado .apkg

  1. Antes de finalizar las tarjetas, consulta:
    • Guía de Diseño de Tarjetas — atomicidad, selección de cloze vs MCQ vs básica, e higiene de diagramas.
    • Presets por Materia — convenciones de campos y jerarquías de etiquetas para medicina clínica, exámenes de posgrado/licencia, y STEM/humanidades.
  2. Valida antes de empaquetar: ejecuta anki_validate_deck (pasa mediaDir si las tarjetas referencian figuras extraídas). Corrige cualquier error bloqueante (invalid_cloze, missing_media, duplicate_card_id, etc.) y considera dividir tarjetas verbosas señaladas por advertencias.
  3. Construye el .apkg: ejecuta anki_build_apkg (subdeckStrategy: "tier" coloca las tarjetas en 01-高频必背, 02-中频常考, 03-真题常规, 04-课件补充, ordenadas para que las tarjetas de exámenes pasados de mayor frecuencia aparezcan primero en la cola due de Anki).

Fase 3: Suplemento Incremental de Diapositivas / Apuntes de Clase (Potenciador de Puntuación)

Una vez que las tarjetas de alto rendimiento de exámenes pasados forman la línea base de aprobación, usa diapositivas de clase (.pptx, .docx, .pdf) para llenar los vacíos restantes del plan de estudios sin sobrescribir o duplicar tarjetas existentes:

  1. Extrae el mazo de diapositivas con anki_extract_source (extractImages: true extrae diagramas/tablas incrustados en media/).
  2. Redacta tarjetas candidatas a partir de las nuevas diapositivas/apuntes.
  3. Ejecuta anki_diff_supplement contra el deck.json existente o el .apkg exportado:
    • Los duplicados exactos se saltan automáticamente.
    • Los casi duplicados (similarity >= nearThreshold) se muestran para revisión; pasa mergeNear: true cuando los detalles de la diapositiva enriquecen una tarjeta de examen pasado existente.
    • Los conceptos nuevos se asignan a source::ppt-supplement y se colocan en 04-课件补充, mientras que cada tarjeta existente mantiene su guid original exacto.
  4. Revalida y reconstruye .apkg (anki_build_apkg). Reimportar en Anki actualiza las notas modificadas en su lugar sin perder el historial de repaso.

Fase 4: Reparación de Tarjetas Atascadas / Leech con Mnemotecnias

Cuando un usuario exporta su mazo activo de Anki (con información de programación, o marca "Support older Anki versions / 兼容旧版 Anki" al exportar .apkg) o apunta a elementos obstinados:

  1. Ejecuta anki_inspect_apkg con tagFilter: "leech" y/o minLapses: 3 (o query para palabras clave específicas) para aislar las tarjetas que siguen fallando en la recuperación.
  2. Aplica el Libro de Jugadas de Mnemotecnias para crear ganchos de memoria cortos y vívidos (acronym, rhyme, homophone, mechanism, contrast, visual, loci) dirigidos específicamente al por qué el usuario confunde esa tarjeta.
  3. Escribe los ganchos en el campo Mnemonic a través de anki_apply_mnemonics (updateOnly: true emite un .apkg de actualización quirúrgica liviana que contiene solo las tarjetas parcheadas con sus GUID originales exactos).
  4. Recuerda al usuario: las mnemotecnias resuelven la codificación inicial para elementos obstinados; la repetición espaciada de Anki mantiene la recuperabilidad a largo plazo — continúa repasando la tarjeta actualizada normalmente.

Skills relacionados