Revisada el 2026-10-08

Skill de Claude Code, propia del proyecto ebooks, que renombra EPUB, AZW3 y MOBI al formato Autor - Serie NN - Título.ext y corrige los metadatos incrustados que lo impiden.1

BookLore y BookOrbit se guían sobre todo por los metadatos incrustados y usan el nombre solo como respaldo, así que la skill deja los dos coherentes. Se activa al añadir libros a la biblioteca, al terminar un libro propio o con «renombra los epub». También es norma del proyecto: todo EPUB, AZW3 o MOBI que entre en la biblioteca o salga a output/finales/ debe cumplirla, y forma parte del criterio de «libro terminado».2

Datos clave
EstadoEn desarrollo: probada en simulación (0 cambios, idempotente); sin probar aplicando correcciones desde la skill
URL—
RepositorioNinguno; vive en el proyecto ebooks (.claude/skills/nombrar-ebooks-bookorbit/)
StackSKILL.md + scripts/nombrar-ebooks.py (107 líneas), ebook-meta de calibre, epubcheck
Inicio2026-10-04

Qué hace

  • Convención: Autor - Serie NN - Título.ext con serie y Autor - Título.ext sin ella. NN con dos cifras; varios autores unidos con &; sin ¡ ¿ ! : ? ni año.1
  • Por defecto solo simula y avisa de metadatos dudosos: sin autor, título con «Spanish Edition», serie sin número, idioma raro o iniciales pegadas.13
  • Con --go aplica el renombrado. Con --fix-meta correcciones.json corrige también título, autor, serie e idioma; con --backup deja copia de los originales.13
  • Si el EPUB pasaba epubcheck y el editado no, aborta.1
  • No toca las carpetas Backup Originales y no vuelve a renombrar los MOBI/AZW3 que ya llevan la serie en el nombre.1

Stack y arquitectura

  • Un SKILL.md de 37 líneas con la convención, los pasos y las reglas ya decididas, y un script aparte que hace el trabajo.1
  • El script lee los metadatos directamente del EPUB (OPF) y usa ebook-meta de calibre para MOBI/AZW3 y para escribir.3
  • Reglas de decisión recogidas en la skill: la serie es una saga real, no una colección de editorial ni la de un libro suelto; mismo nombre de serie en todos los tomos; idioma del contenido, no el de la tienda.1

Lecciones

  • Se validó el 2026-10-04 con los 107 libros de 02.- Infantiles: 30 ficheros necesitaron corregir metadatos (series sin número, autores con variantes, idioma erróneo, «Spanish Edition»).4
  • En MOBI/AZW3 solo se puede escribir título y autor; el formato no guarda serie, que queda solo en el nombre.1
  • Renombrar un fichero hace perder el progreso de lectura en BookLore, que indexa por ruta.1
  • Las rutas del NAS vienen con tildes en NFD y copiar con copy2 falla por SMB: el script compara en NFC y se copia con shutil.copyfile.1

Pendiente

  • La primera vez que se use con --go y correcciones, probarla sobre pocos libros: el renombrado del 2026-10-04 se hizo con scripts de usar y tirar.
  • Faltan Harry Potter EN 6 y Futbolísimos 3 y 29+ en la biblioteca.4

Véase también

Referencias

Footnotes

  1. .claude/skills/nombrar-ebooks-bookorbit/SKILL.md, proyecto ebooks. Archivo local de la skill, creado el 2026-10-04. Consultado el 2026-10-04. ↩ ↩2 ↩3 ↩4 ↩5 ↩6 ↩7 ↩8 ↩9 ↩10 ↩11

  2. CLAUDE.md del proyecto ebooks (norma de nombrado y criterio de libro terminado). Consultado el 2026-10-04. ↩

  3. scripts/nombrar-ebooks.py, proyecto ebooks. Consultado el 2026-10-04. ↩ ↩2 ↩3

  4. contexto/decisiones.md del proyecto ebooks, entrada del 2026-10-04. Consultado el 2026-10-04. ↩ ↩2