Communitygithub.com

zhangys11/agent-skills

Habilidades reutilizables para agentes de IA (SKILL.md). Incluye obsidian-pdf: Markdown -> PDF estilo Obsidian (pandoc + Chromium sin cabeza).

¿Qué es agent-skills?

Esta habilidad de agente, `md2tex`, convierte manuscritos académicos en Markdown a archivos LaTeX (.tex) listos para enviar a revistas científicas. Es útil para investigadores, estudiantes y desarrolladores que escriben en Markdown y necesitan cumplir con los formatos estrictos de revistas como Physical Review (revtex), IEEE Transactions (ieeetran) o arXiv (article estándar). Admite la conversión completa de encabezados, texto en negrita y cursiva, tablas estilo pipe, imágenes (incluyendo enlaces de Obsidian), matemáticas en línea y en display, listas con viñetas, caracteres Unicode especiales (griegos, símbolos) y citas bibliográficas. También procesa pies de imagen y tabla, y permite personalizar el preámbulo LaTeX. Funciona en cualquier sistema con Python 3 y genera archivos .tex que pueden compilarse a PDF con `pdflatex`. Está diseñado específicamente para la estructura de artículos académicos (IMRaD + material suplementario) y no es un convertidor de propósito general.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add zhangys11/agent-skills

Preguntar en tu IA favorita

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

Vista previa

Del README del skill

alt

Documentación

Conversor de Markdown a LaTeX (md2tex)

Convierte manuscritos académicos en Markdown a archivos LaTeX .tex adecuados para el envío a revistas. Maneja el pipeline completo de conversión: encabezados, negrita/cursiva, tablas tipo pipe, imágenes, matemáticas en línea y en display, listas con viñetas, caracteres Unicode especiales y formato de citas.

Inicio rápido

# Simple: convierte un solo .md a .tex con clase article
python3 scripts/md2tex.py paper.md -o output/

# Elegir una clase de documento predefinida
python3 scripts/md2tex.py paper.md -o output/ --class ieeetran
python3 scripts/md2tex.py paper.md -o output/ --class revtex

# Múltiples archivos: manuscrito principal + apéndice como material suplementario
python3 scripts/md2tex.py main.md --appendix appendix.md -o output/ --class revtex

# Sobrescribir preámbulo personalizado (añadir paquetes, comandos, etc.)
python3 scripts/md2tex.py paper.md --preamble my_preamble.tex -o output/

# Compilar PDFs después de la generación
python3 scripts/md2tex.py paper.md -o output/ --compile

Las rutas anteriores son relativas al directorio base de esta habilidad.

Qué hace

El script lee Markdown y produce LaTeX aplicando estas conversiones:

MarkdownLaTeX
## Sección\section{Sección}
### Subsección\subsection{Subsección}
#### Subsubsección\subsubsection{Subsubsección}
**negrita**\textbf{negrita}
*cursiva*\textit{cursiva} (consciente de matemáticas: omite $...$)
$$...$$$$...$$ (paso directo)
$...$$...$ (paso directo)
| ... | tablas pipe\begin{tabular}...\end{tabular}
![alt](ruta)\begin{figure}\includegraphics...\caption...\end{figure}
![[ruta|alt]] (Obsidian)Igual que arriba
- viñeta\begin{itemize}\item...\end{itemize}
α, β, ∞, →, × etc.$\alpha$, $\beta$, $\infty$, $\to$, $\times$
--- (raya)--- (preservado)

Procesamiento adicional

  • Pies de imagen: Busca líneas **Fig. N | ...** o **Fig. N.** después de las imágenes para construir el \caption{...} adecuado.
  • Pies de tabla: Busca bloques **Tabla N | ...** o **TABLA N** que preceden a las tablas pipe.
  • Matemáticas Unicode: Mapea α β γ ε λ μ π ρ σ ω Γ Λ Σ Ω ∞ → ← × ± ≤ ≥ ≈ ≠ ¬ a sus equivalentes LaTeX.
  • Caracteres acentuados: Mapea é è ê ñ ö ü â î ô a escapes LaTeX.
  • Comillas inteligentes: "" '' a `` ''.
  • ł polaco: Białynicki → Bia{\\l}ynicki para una representación correcta.
  • Limpieza de líneas en blanco: Reduce 4+ líneas en blanco a 2.
  • Eliminación de citas en bloque: Opcionalmente elimina líneas > ....

Clases de documento predefinidas

PredefinidaClase de documentoCaso de uso
article (por defecto)\documentclass[12pt]{article}Artículos generales, arXiv
revtex\documentclass[aps,pra,preprint]{revtex4-2}Revistas Physical Review
ieeetran\documentclass[journal,onecolumn,12pt]{IEEEtran}Transacciones IEEE

Cada predefinida incluye paquetes apropiados (graphicx, amsmath, amssymb, hyperref, booktabs, array).

Preámbulo personalizado

Crea un archivo .tex que contenga tu preámbulo completo (paquetes, comandos, etc.) y pásalo con --preamble. La predefinida para cada clase se sobrescribe.

Ejemplo my_preamble.tex:

\documentclass[aps,pra,reprint]{revtex4-2}
\usepackage{graphicx}
\usepackage{amsmath,amssymb}
\usepackage{hyperref}
\usepackage{booktabs}
\usepackage{xcolor}
\newcommand{\pbox}[2]{\parbox{#1}{\vspace{4pt}\RaggedRight #2\vspace{4pt}}}

Manejo de citas

Dos modos, se establecen con --cite:

bibtex (por defecto)

Mantiene las claves BibTeX en el texto: \cite{key2020}. Por defecto lee las claves de cita de una sección de referencias o archivo de bibliografía. Los marcadores de cita estilo [N] se dejan como están a menos que se proporcione --cite-map.

inline

Incrusta \begin{thebibliography}...\end{thebibliography} con entradas escritas a mano. Usa --biblio references.tex para proporcionar el contenido de la bibliografía.

Opciones avanzadas

--title "Título del artículo"     Sobrescribe el título del documento (por defecto: primer encabezado #)
--author "Nombre"                   Nombre del autor
--affiliation "Universidad"         Afiliación del autor
--email "[email protected]"         Correo electrónico de correspondencia
--abstract                           Extraer resumen de la sección ## Resumen (por defecto: automático)
--no-abstract                        Omitir extracción de resumen
--appendix apéndice.md               Convertir apéndice como material suplementario
--suppress-numbers                   Usar \section*{} (sin numeración, para material suplementario)
--cite-map mapa.json                 Mapeo JSON de marcadores de cita a claves BibTeX
--compile                            Ejecutar pdflatex dos veces después de la generación
--fig-dir figuras/                   Directorio del que copiar figuras (por defecto: detección automática)
--help                               Mostrar uso completo

Sugerencias de compilación

Después de generar los archivos .tex, compila con:

# REVTeX (requiere revtex4-2.cls instalado)
cd output/ && pdflatex main.tex && pdflatex main.tex

# IEEEtran (requiere IEEEtran.cls instalado)  
cd output/ && pdflatex main.tex && pdflatex main.tex

El script detecta automáticamente las figuras referenciadas en el markdown y las copia del directorio fuente al directorio de salida.

Limitaciones

  • No es un convertidor de propósito general: Diseñado para la estructura de artículos académicos (IMRaD + material suplementario). Las listas anidadas complejas, los bloques de código y las notas al pie pueden requerir ajustes manuales.
  • Solo tablas pipe: Las etiquetas HTML <table> no se convierten.
  • Viñetas de un solo nivel: Actualmente maneja anidación de 2 niveles; las listas más profundas pueden aplanarse.
  • Entornos matemáticos: \begin{aligned}...\end{aligned} etc. pasan sin cambios; asegúrate de que son LaTeX válido.
  • Conversión de citas: [N] a \cite{} requiere un archivo de mapeo proporcionado por el usuario o un posprocesamiento manual.
  • Sin recarga en vivo: Regenera .tex después de cada edición de .md; la habilidad no vigila archivos.

Para renderizado PDF estilo Obsidian (A4, Arial, MathJax), usa la habilidad obsidian-pdf.

Skills relacionados