Rylaispirit/rylai-codex-hermes-skills

Crear, inspeccionar, extraer, fusionar, dividir, rotar y renderizar archivos PDF con herramientas locales de código abierto, incluyendo verificación estructural y visual.

¿Qué es rylai-codex-hermes-skills?

Esta habilidad proporciona un conjunto completo de herramientas para manejar archivos PDF utilizando bibliotecas locales de código abierto como pypdf, pdfplumber, pypdfium2 y Poppler. Permite realizar operaciones como inspección de metadatos y páginas, extracción de texto, fusión de múltiples PDFs, división de páginas específicas, rotación de páginas y renderizado de páginas a imágenes PNG para verificación visual. La habilidad prioriza el trabajo con archivos locales y deterministas, preservando el documento fuente a menos que el usuario solicite explícitamente su reemplazo. Está diseñada para agentes de IA como Claude Code, Cursor o Codex, y se ejecuta en Python 3, instalando solo las dependencias faltantes. Incluye un script CLI unificado (rylai_pdf.py) que maneja todas las operaciones, con una barra de calidad que exige que la salida se abra sin advertencias, que el orden y conteo de páginas coincidan con lo solicitado, y que se identifiquen páginas escaneadas sin capa de texto.

Compatible con✓Claude Code✓Codex CLI~Cursor

npx skills add https://github.com/Rylaispirit/rylai-codex-hermes-skills/tree/HEAD/skills/pdf

Documentación

Rylai PDF

Habilidad original de Codex-Hermes-Claude por Rylai.

Usa archivos locales y herramientas deterministas. Preserva el documento fuente a menos que el usuario solicite explícitamente un reemplazo directo. Nunca inventes contraseñas, incrustes credenciales ni subas documentos a un servicio externo sin aprobación directa.

Entorno de ejecución

Usa Python 3 con:

pypdf para inspección y edición a nivel de página.
pdfplumber cuando sea útil una extracción de texto de mayor calidad.
pypdfium2 o Poppler pdftoppm para renderizado opcional de páginas.
LibreOffice solo al convertir una fuente de Office a PDF.

Verificar antes de instalar:

python -c "import pypdf; print(pypdf.__version__)"
python -c "import pdfplumber; print(pdfplumber.__version__)"

Instalar solo los paquetes de Python que falten:

python -m pip install pypdf pdfplumber pypdfium2

Resuelve scripts/rylai_pdf.py relativo al directorio de esta habilidad.

Flujo de trabajo

Confirma la ruta de entrada, la operación solicitada, la ruta de salida y el rango de páginas.
Ejecuta info antes de editar un PDF desconocido o cifrado.
Escribe en una nueva ruta de salida. Usa --force solo cuando se pretenda reemplazar.
Vuelve a abrir el resultado y verifica el conteo de páginas, metadatos y texto extraído cuando sea aplicable.
Para trabajos sensibles al diseño, renderiza páginas representativas e inspecciona la salida PNG.
Informa sobre verificaciones omitidas cuando Poppler, LibreOffice, OCR u otra dependencia opcional esté ausente.

Para páginas escaneadas sin capa de texto útil, usa un motor OCR local disponible. Conserva el PDF original e indica qué herramienta OCR y modelo de lenguaje se usaron.

CLI integrada

Inspeccionar:

python scripts/rylai_pdf.py info input.pdf

Extraer páginas seleccionadas:

python scripts/rylai_pdf.py extract input.pdf output.txt --pages 1-3,7

Fusionar:

python scripts/rylai_pdf.py merge output.pdf first.pdf second.pdf

Dividir páginas seleccionadas en archivos individuales:

python scripts/rylai_pdf.py split input.pdf output-pages --pages 2-5

Rotar páginas seleccionadas en sentido horario:

python scripts/rylai_pdf.py rotate input.pdf rotated.pdf 90 --pages 1,3

Renderizar con PDFium o Poppler local:

python scripts/rylai_pdf.py render input.pdf rendered-pages --dpi 144

Agrega --password solo cuando el usuario haya proporcionado la contraseña para ese documento.

Barra de calidad

La salida se abre sin advertencias de reparación.
El orden de páginas, conteo, rotación y rangos seleccionados coinciden con la solicitud.
El texto extraído no está vacío silenciosamente; se identifican las páginas escaneadas.
Las páginas renderizadas no tienen recortes inesperados ni salida en blanco.
Ningún archivo fuente, archivo temporal, contraseña o ruta de usuario se empaqueta con la habilidad.