Agent skill · magnus919
gutenberg
Search, download, and extract public-domain books from Project Gutenberg.
What it needs
About 5k tokens when loaded.
What this skill does
Gutenberg — Public Domain Book Toolkit Search, download, and extract clean text from Project Gutenberg — 70,000+ free public-domain ebooks. Ships a portable Python CLI with zero external dependencies. Quick Start How It Works Project Gutenberg provides 70,000+ free public-domain ebooks in multiple formats. The gutendex API (https://gutendex.com) offers a free, unauthenticated JSON catalog. No API key required — just curl or this CLI. Data Flow CLI Reference search — Find books by keyword Returns: ID, title, author (with life dates), language, subjects, download count. Results sorted by download count (most popular first). metadata — Get full metadata for a book by ID Returns: title, author(s), language(s), subjects, bookshelves, summaries, copyright status, download count, and all available format URLs. download — Download a book by Gutenberg ID The file is saved to ./gutenberg-<id>.<ext> (or --output path). Large books may take a moment. extract — Strip PG boilerplate and produce clean text Output: clean text without the Project Gutenberg license header/footer. For EPUB extraction (illustrated books), extracts text from all XHTML files and merges them into a single cleaned document. Size detection: if a plain-text download is under 50KB for a known substantial book, warns that the text may be truncated and recommends EPUB mode. classify — Classify fiction vs non-fiction Uses the book's subjects and bookshelves to classify: Fiction signals: "Fiction", "novels", "short stories", "poetry", "drama", "fantasy", "horror" Non-fiction signals: "Essays", "History", "Philosophy", "Biography", "Science", "Religion" Returns: fiction, non-fiction, or ambiguous (with explanation of why). pipeline — Full fetch pipeline Runs: search (if title) → metadata → download (txt) → check size → extract (or EPUB fallback) → classify. Prints an executive summary at the end. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills magnus919/gutenberg