Communitygithub.com

slides-genedit

Genera y edita presentaciones académicas a partir de material de investigación. Dos rutas: (1) crear una nueva presentación desde un artículo/apuntes con restricciones de audiencia, duración y número de diapositivas, con afirmaciones por diapositiva, mapa de evidencia textual, notas del orador y una vista previa en PDF; (2) ediciones conservadoras de una presentación existente: inventariarla, aplicar solo los cambios locales solicitados y demostrar que las diapositivas no modificadas permanecen byte-idénticas. Úsalo cuando te pidan convertir material de investigación en diapositivas o modificar/comprimir/cambiar de audiencia una presentación existente sin romperla.

¿Qué es slides-genedit?

slides-genedit es una habilidad para agentes de IA (como Claude Code, Cursor, Codex) que permite generar y editar presentaciones académicas en PowerPoint de manera inteligente y conservadora. La habilidad ofrece dos rutas principales: GENERATE, que crea una nueva presentación desde material de investigación (artículos, apuntes) respetando restricciones de audiencia, tiempo y número de diapositivas; y EDIT, que modifica solo las diapositivas específicas de una presentación existente, asegurando que el resto permanezca sin cambios (byte-idénticas). La habilidad utiliza scripts en la carpeta `scripts/` para tareas deterministas como análisis, montaje, verificación y renderizado, mientras que el agente se encarga de la selección y ordenamiento del contenido. Es útil para investigadores, estudiantes y profesionales que necesitan convertir rápidamente material de investigación en presentaciones listas para exponer, o ajustar presentaciones existentes a nuevas audiencias o limitaciones de tiempo, todo con trazabilidad de evidencia (citas textuales) y notas del orador. La habilidad prioriza la honestidad sobre el éxito fingido, registrando decisiones y limitaciones en un archivo `result.json`.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/qingyulzx/pku-efficiency3-skills/tree/HEAD/slides-genedit

Preguntar en tu IA favorita

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

Documentación

slides-genedit — generación y edición académica de presentaciones con preservación del origen

Conviertes material de investigación (artículo, apuntes, presentación inicial) en una presentación académica editable y trazable por evidencia — y editas presentaciones existentes sin romper lo que no se te pidió tocar. La parte difícil es la selección y el orden, no copiar párrafos: qué resultado merece su propia diapositiva, cuántos viñetas necesita un método, qué figura va primero, qué se recorta cuando se excede el presupuesto de diapositivas. Tú tomas esas decisiones; los scripts en scripts/ hacen el trabajo determinista (análisis, montaje, verificación, renderizado). Nunca ensambles XML a mano cuando exista un script.

Despacho de ruta (decide primero, nunca mezcles)

Lee /input/case.json y task.md. Ejecuta el paso 1 a continuación — parse_case.py imprime una pista de ruta con su evidencia. Confirma con el texto de la tarea:

  • GENERATE — no hay presentación inicial en las entradas (material de investigación + restricciones de audiencia/tiempo/número de diapositivas + plantilla). Construye una nueva presentación.
  • EDIT — se proporciona una presentación inicial (.pptx) Y la instrucción solicita cambios locales (修改/压缩/换受众/加页/删页/调整). Inventaríala y aplica operaciones quirúrgicas. La edición debe preservar: diapositivas no tocadas byte-idénticas, maestros/diseños sin cambios, estilo de la plantilla, notas de diapositivas no objetivo.
  • Si existe una presentación pero la instrucción reescribe la mayor parte del contenido o reordena toda la narrativa, es una ejecución generate disfrazada — construye desde cero con la misma plantilla y conserva la presentación inicial como versión N-1. Registra la decisión de ruta y su evidencia.

Disciplina de presupuesto en todo momento: ~7 pasos de herramienta es el punto óptimo, 64 solicitudes de modelo / 900 s en total. El paso 1 ya escribe un esqueleto result.json completo de contrato, por lo que un fallo en cualquier punto posterior aún deja un entregable verificable. Mejóralo incrementalmente; nunca lo dejes como el esqueleto.

Paso 1 — analizar entradas, escribir la base de result.json (ambas rutas)

python scripts/parse_case.py --input /input/case.json --workdir /app/work --output-dir /app/output

Lee la pista de ruta impresa Y el texto real de la tarea antes de comprometerte con una ruta (la pista es evidencia, no un veredicto). Verifica el escaneo de restricciones (case-parsed.json) contra task.md tú mismo — los escaneos de palabras clave fallan y coinciden en exceso; el texto de la tarea es el que vale. Lee cada archivo de entrada que exista (material*.md/pdf/tex, figuras); para PDFs usa pdf-text-tool / pdf-render-tool / ocr-tool según estén disponibles. Nunca asumas contenido a partir de nombres de archivo.

Paso 2 — extracción con captura textual (generate)

Del material real, extrae: pregunta de investigación, método, resultados, limitaciones (la columna vertebral narrativa). Mientras lees, captura citas textuales con ubicaciones (sección, tabla, figura) para cada número y afirmación que pueda aparecer en una diapositiva — este es el mapa de evidencia, recopilado una vez, reutilizado en los pasos 3 y 7. Si al material le faltan conclusiones/resultados, aplica reference/exception-playbook.md #1: marca inferencias, nunca inventes.

Paso 3 — esquema por diapositiva: tu criterio, registrado (generate)

Redacta /app/work/outline.json según reference/schemas.md. Este es el paso intelectual central — hazlo tú mismo, no por plantilla:

  • Una diapositiva = una afirmación. El título expresa el mensaje de la diapositiva ("Resultados: error de forma 38,2% menor a igual tasa de compresión", no "Resultados experimentales"). Cada diapositiva recibe un role (problema/método/resultado/limitación/...) y notas del orador (notes) (el guion de la charla — una presentación sin notas está incompleta).
  • Números textuales. Copia los dígitos del material exactamente (28,4 BLEU, no ~28; 41,8, no 42). La fuente de cada número va en la evidence de esa diapositiva. Si no puedes encontrar la fuente de un número, este no va en una diapositiva.
  • Selección para la audiencia/presupuesto de tiempo. ~1 diapositiva por cada 1–2 minutos. Compañeros de grupo: los detalles del método importan. Comité de revisión: el progreso y el plan importan. Defensa: las contribuciones y la evidencia importan. Ordena los resultados por fuerza narrativa (¿es bueno? → ¿cuánto? → ¿se sostiene?), no por el orden de las secciones del artículo.
  • Figuras: cita la imagen original con su pie de foto textual cuando la fuente sea un mapa de bits; solo redibuja cuando exista la tabla de datos. Los resultados solo de imagen merecen su propia diapositiva; las figuras secundarias se fusionan o van a diapositivas de respaldo después de la diapositiva de cierre.
  • Registro de decisions: cada elemento conservado/recortado/fusionado/reordenado con una razón ("recortado Tabla 2 de ablación — presupuesto de 6 diapositivas, resultados principales primero"). Esto es tanto tu artefacto de verificabilidad como el material de estudio de caso; las decisiones vacías son un error.

Paso 4 — montar la presentación (generate)

python scripts/assemble_deck.py --outline /app/work/outline.json \
  --template <template.pptx si se proporciona> --out /app/output/deck_v1.pptx \
  --workdir /app/work/scratch

Lee assembly-report.json. Corrige el esquema (no la presentación) cuando informe riesgo de desbordamiento, fallos de diseño o exceso de presupuesto, luego vuelve a ejecutar — la presentación y el registro de decisiones deben permanecer consistentes. Los scripts garantizan: el contenido se coloca en marcadores de posición a nivel de diapositiva (clonados del diseño cuando faltan — escribir en marcadores de posición de diseño no se renderiza), las imágenes se recortan en relación de aspecto sin distorsión, las notas se adjuntan.

Paso 2' — inventariar la presentación inicial (edit)

python scripts/inventory_deck.py --deck <inicial.pptx> --out /app/work/inventory.json

Lee el inventario. Localiza los objetivos exactos que nombra la instrucción (índice de diapositiva + marcador de posición/ nombre de forma). Si un objetivo de edición no existe, aplica el manual de excepciones #8: falla con claridad, redirige o añade — nunca lo omitas en silencio.

Paso 3' — redactar operaciones quirúrgicas (edit)

Escribe /app/work/ops.json según reference/schemas.md (esquema de operaciones). Las operaciones se aplican en orden a índices de diapositiva basados en 1. Cubre SOLO lo que pide la instrucción: replace_text para viñetas reescritas (el formato existente se conserva), append_bullets, set_notes, insert_image (recortada en relación de aspecto), add_slide, delete_slide, move_slide, duplicate_slide. Una reescritura completa de la presentación mediante operaciones es un mal uso — cambia de ruta en su lugar.

Paso 4' — aplicar ediciones y verificar preservación (edit)

python scripts/edit_deck.py --deck <inicial.pptx> --ops /app/work/ops.json \
  --out /app/output/deck_v2.pptx --workdir /app/work/scratch

Verifica edit-report.json: todas las operaciones ok; slides_identical_raw >= diapositivas fuente − diapositivas tocadas; masters_untouched y layouts_untouched verdaderos. Si las diapositivas no tocadas no son ni siquiera estructuralmente idénticas, la edición se ha filtrado — manual de excepciones #9. Vuelve a renderizar, luego entrega.

Paso 5 — renderizar y verificar (ambas rutas)

python scripts/render_check.py --pptx /app/output/deck_v1.pptx --outdir /app/output/render/

La vista previa en PDF debe existir con un número de páginas igual al número de diapositivas. Inspecciona la vista previa en busca de desbordamiento, sustitución de fuentes, imágenes recortadas (usa pdf-render-tool / office-renderer según estén disponibles). La sustitución de fuentes en la vista previa se registra como incertidumbre — NO reescribas las fuentes de la plantilla de la presentación para complacer al renderizador (manual de excepciones #4). Si el renderizado es imposible, conserva el .pptx y registra el fallo honestamente (manual de excepciones #6).

Paso 6 — iterar deliberadamente (ambas rutas)

Los comentarios del usuario llegan como una nueva instrucción de edición sobre la presentación actual: vuelve al paso 2' (ruta de edición) con la última versión. Conserva las versiones anteriores (deck_v1.pptx, deck_v2.pptx, ...) — nunca sobrescribas; cada informe de renderizado más el registro de operaciones/diferencias de decisiones es el registro de versión. Verificación de regresión en cada ronda: ¿las diapositivas no tocadas permanecieron idénticas?

Paso 7 — finalizar result.json (ambas rutas)

Actualiza /app/output/result.json (el esqueleto del paso 1) con los valores finales: cada campo output_contract de case.json completado — archivo de presentación, número de diapositivas, mapa de evidencia por diapositiva (ubicación + cita textual), ruta de vista previa del renderizado, estado de las notas del orador; las ejecuciones de edición añaden el registro de operaciones y la matriz de preservación. Los campos que realmente no pudiste producir se quedan null con la razón en unanswered. status ∈ complete | partial (nombra los límites). Luego detente — entrega el .pptx, las notas, la vista previa en PDF y result.json.

No negociables

  • Los números/citas en las diapositivas se rastrean hasta fuentes capturadas textualmente; sin figuras inventadas, sin redibujados a ojo, sin redondeos silenciosos.
  • La ruta de edición nunca toca maestros/diseños ni diapositivas no objetivo; la matriz de preservación lo demuestra.
  • Fallo honesto sobre éxito fingido en result.json, siempre.
  • Las plantillas, dependencias, esquemas y el manual de excepciones están en README.md y reference/; léelos antes de desviarte.

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

biopathway-mechanism-diagram

Build or edit publication-grade biological mechanism/pathway diagrams from research materials (PDF/text) as a challengeable mechanism statement - three-layer model (typed entities, typed directed edges with verbatim evidence, compartment layout), semantics-correct SVG source, PNG/PDF exports and a traceable, uncertainty-aware result.json. Use for tasks asking to draw, generate or edit signaling pathways, mechanism figures, crosstalk diagrams or pathway flowcharts; refuses to guess regulation direction and marks unstated information instead.

graphical-abstract-builder

Build a single-page graphical abstract (question, method, results, conclusion) from research material as a traceable, editable SVG with PNG/PDF exports. Use when asked to create or edit a graphical abstract, science summary figure, mechanism or flow diagram, or data chart from a paper, study notes or experimental records, especially when editable source files and element-to-source traceability are required.

paper-to-academic-ppt

Turn a research paper (PDF) into a structured, evidence-traceable, template-compliant academic slide deck. Two phases: agent-authored narrative spine and page-level claims (each with paper locators and verbatim quotes), then scripted template adaptation that writes content into real master/layout placeholders, embeds original paper figures, checks overflow/aspect/notes, and exports a PDF preview. Handles missing conclusions, figure-trimming, layout mismatch and over-limit slide counts with explicit rules.

relationship-schematic

Generate or edit scientific entity-relationship schematics (mechanism diagrams, pathway chains, experimental workflows, structural containment) as traceable, editable SVG with verified relation semantics. Extracts an evidence-quoted entity/relation table first, renders a layered SVG from it, reads the drawing back to verify every relation type, direction and containment, then exports 300-dpi PNG and vector PDF. Use for any "draw a mechanism/workflow/relationship figure from this paper or case material" task where scientific correctness of entities, arrow directions and hierarchy matters.

Skills relacionados