Turn any technical book PDF into a Claude Code skill — ready to study, reference, and use while you work.
Python agent-skillsai-agentsbook-to-skillcontext-engineeringdocument-processingedtechknowledge-baseknowledge-managementllmpdf-to-markdownragself-studystudy-tools
chore(release): v1.4.0
virgiliojr94387d938ec58e
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex 7150da9..31ba423 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -5,28 +5,67 @@ All notable changes to **book-to-skill** are documented here.The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).-> **Do not edit this file by hand.** From the next release on it is generated-> from Conventional Commit messages by [git-cliff](https://github.com/orhun/git-cliff)+> **Do not edit this file by hand.** It is generated from Conventional Commit+> messages by [git-cliff](https://github.com/orhun/git-cliff)> (`git-cliff --tag vX.Y.Z -o CHANGELOG.md`). Write a good PR title instead — it> becomes the changelog entry. See `cliff.toml` and CONTRIBUTING.md.-## [Unreleased]+## [1.4.0] - 2026-08-10++### Added+- Warn on unknown CLI flags instead of silently ignoring (#89)+- Make the site indexable and shareable+- Add Booklin banner and hand-made share card+- Apply pdftotext cleanup to pypdf and pdfminer paths too (#101)++### Documentation+- Sync architecture, skill spec, and README with v1.3.0+- Reserve README project listings for sponsors+- Add Booklin mascot to the README (#106)+- Split README into pages and add Booklin mascot set (#110)+- State that scanned PDFs need OCR first (#132)### Fixed-- **CJK-aware token estimate** — `estimate_tokens` now counts CJK codepoints- directly (against `CJK_CHARS_PER_TOKEN`) instead of whitespace-delimited words,- fixing a ~1000× undercount for space-less Chinese/Japanese books in the cost- pre-flight. Latin behavior is unchanged and the estimate stays deterministic- and dependency-free (rescued from #70).--### Removed-- **Stale tracked bytecode** — `scripts/__pycache__/extract.cpython-313.pyc` was committed- alongside the EPUB-support change and has been tracked ever since, despite `.gitignore`- listing both `*.pyc` and `__pycache__/` (ignore rules do not untrack already-committed- files). The file was inert — its timestamp-based header records a 11,321-byte source while- `scripts/extract.py` is now 871 bytes, so Python always invalidated it and recompiled — but- committed bytecode is not reviewable in a diff. A regression test now fails if any `.pyc`- or `__pycache__/` path is tracked.+- Gate lowercase Roman behind heading context, add FP coverage (#88)+- CJK-aware token estimate (rescued from #70) (#103)+- Support documented help flags (#97)+- Emit block boundaries at end tags in the stdlib parser (#107)+- Skip control destination groups in the dependency-free fallback (#109)+- Scrub bidirectional controls and remaining invisible code points (#108)+- Write metadata.json as UTF-8 (#105)+- Detect Markdown-prefixed chapter headings (#91) (#92)+- Reserve the banner's space on the site build+- Abort early on scanned PDFs with an OCR hint (#130)+- Stop edge-of-page cleanup deleting real one-word lines (#119)+- Expand `~` in input paths (#118)+- Skip an unreadable source instead of aborting the batch (#120)+- Detect a table of contents in any source, not just the first (#114)+- Scan nested chapters and report markdown left out of scope (#115)+- Detect whitespace-separated CJK ToC headers (#112)+- Stop duplicating the PR number in generated entries (#131)++### Miscellaneous+- Untrack stale compiled bytecode (#94)+- Generate CHANGELOG from commits with git-cliff (#104)++### Notes on selected changes++*Written by hand before this file became generated; kept for the detail the+one-line entries above do not carry.*++**CJK-aware token estimate** — `estimate_tokens` now counts CJK codepoints+directly (against `CJK_CHARS_PER_TOKEN`) instead of whitespace-delimited words,+fixing a ~1000× undercount for space-less Chinese/Japanese books in the cost+pre-flight. Latin behavior is unchanged and the estimate stays deterministic+and dependency-free (rescued from #70).++**Stale tracked bytecode** — `scripts/__pycache__/extract.cpython-313.pyc` was committed+alongside the EPUB-support change and has been tracked ever since, despite `.gitignore`+listing both `*.pyc` and `__pycache__/` (ignore rules do not untrack already-committed+files). The file was inert — its timestamp-based header records a 11,321-byte source while+`scripts/extract.py` is now 871 bytes, so Python always invalidated it and recompiled — but+committed bytecode is not reviewable in a diff. A regression test now fails if any `.pyc`+or `__pycache__/` path is tracked.## [1.3.0] - 2026-07-30diff --git a/cliff.toml b/cliff.tomlindex b0d5f2f..747f96c 100644--- a/cliff.toml+++ b/cliff.toml@@ -17,8 +17,12 @@ All notable changes to **book-to-skill** are documented here.The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).-This file is generated from Conventional Commit messages by-[git-cliff](https://github.com/orhun/git-cliff) — do not edit it by hand.++> **Do not edit this file by hand.** It is generated from Conventional Commit+> messages by [git-cliff](https://github.com/orhun/git-cliff)+> (`git-cliff --tag vX.Y.Z -o CHANGELOG.md`). Write a good PR title instead — it+> becomes the changelog entry. See `cliff.toml` and CONTRIBUTING.md.+"""body = """{% if version %}\diff --git a/pyproject.toml b/pyproject.tomlindex 4a2f928..4aacdd1 100644--- a/pyproject.toml+++ b/pyproject.toml@@ -4,7 +4,7 @@ build-backend = "hatchling.build"[project]name = "book-to-skill"-version = "1.3.0"+version = "1.4.0"description = "Convert books and documents into structured, on-demand agent skills."readme = "README.md"requires-python = ">=3.9"