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 | |
|---|---|
| Estado | En desarrollo: probada en simulación (0 cambios, idempotente); sin probar aplicando correcciones desde la skill |
| URL | — |
| Repositorio | Ninguno; vive en el proyecto ebooks (.claude/skills/nombrar-ebooks-bookorbit/) |
| Stack | SKILL.md + scripts/nombrar-ebooks.py (107 líneas), ebook-meta de calibre, epubcheck |
| Inicio | 2026-10-04 |
Qué hace
- Convención:
Autor - Serie NN - Título.extcon serie yAutor - Título.extsin 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
--goaplica el renombrado. Con--fix-meta correcciones.jsoncorrige también título, autor, serie e idioma; con--backupdeja copia de los originales.13 - Si el EPUB pasaba epubcheck y el editado no, aborta.1
- No toca las carpetas
Backup Originalesy no vuelve a renombrar los MOBI/AZW3 que ya llevan la serie en el nombre.1
Stack y arquitectura
- Un
SKILL.mdde 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-metade 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
copy2falla por SMB: el script compara en NFC y se copia conshutil.copyfile.1
Pendiente
- La primera vez que se use con
--goy 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
-
.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 -
CLAUDE.mddel proyecto ebooks (norma de nombrado y criterio de libro terminado). Consultado el 2026-10-04. ↩ -
scripts/nombrar-ebooks.py, proyecto ebooks. Consultado el 2026-10-04. ↩ ↩2 ↩3 -
contexto/decisiones.mddel proyecto ebooks, entrada del 2026-10-04. Consultado el 2026-10-04. ↩ ↩2