Menu
Stub out a new book review file with front matter and template captures. Use when adding a new book to _books/.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Development reference for the alexgude.com Jekyll site. Use when modifying plugins in _plugins/, writing or editing content in _posts/ or _books/, working with the markdown output pipeline, book families, build validators, CI/CD configuration, the AT Protocol / standard.site / Bluesky publishing pipeline (_scripts/atproto/), or content authoring conventions (excerpts, Liquid tags, linking).
Parse rough book-review notes into Liquid capture blocks. Use when starting a book review to turn voice-transcribed notes into template variables for books, authors, and series mentioned.
Navigate between Jekyll plugins and their tests. Use when working on _plugins/ or _tests/, finding untested code, or reviewing test coverage.
Edit blog posts and book reviews. Use `/copyedit grammar` for spelling/grammar only, or `/copyedit polish` for fuller editing. Preserves the author's voice and style.
| name | stub-book |
| description | Stub out a new book review file with front matter and template captures. Use when adding a new book to _books/. |
Create a new book review stub in _books/ with full front matter and
standard capture blocks.
/stub-book <title> --- The user may also provide author, series, book
number, or a Wikidata QID. If not provided, look them up.
Establish title, author, series, and book number. If the book is part of
a series already reviewed on the site, check an existing _books/ entry
for the correct names and numbering convention.
cd _scripts/metadata && uv run fetch_book_metadata.py "Book Title"
The script prints numbered search results to stderr. Pick the entry for the original novel/work, not a specific edition or translation. If no match, proceed without a QID.
uv run _scripts/skills/stub_book.py \
--title "The Honor of the Queen" \
--author "David Weber" \
--series "Honor Harrington" \
--book-number 2 \
--qid Q3400447
Flags: --title (required), --author (required), --series,
--book-number (default: 1), --qid, --output/-o.
Omit --series for standalone books.
cd _scripts/metadata && uv run update_book_metadata.py _books/<slug>.md
Fetches ISBN, publication date, same_as_urls, and awards from Wikidata.
Updates the file in place.
Check the metadata for issues that need manual fixes:
date_published --- Wikidata dates may be year-only. Refine to
YYYY-MM using Goodreads or the publisher's site.update_book_metadata.py prefers an English-language
edition, but Wikidata's data is incomplete often enough to warrant a
spot check. The ISBN should be ISBN-13 format (978-...). If it looks
wrong, list all editions:
cd _scripts/metadata && uv run list_editions.py Q_WORK_ID
requests/urllib calls get a 403 --- Wikimedia requires a
User-Agent header).same_as_urls --- Work-level Wikidata entities have the richest
URLs. If you used an edition QID, check whether a work entity exists.uv run _scripts/content/make_pages.py
cd _scripts/metadata && uv run fetch_author_same_as.py "Author Name"
make_pages.py creates stub pages for any new authors or series.
fetch_author_same_as.py prints search results --- pick the person
entry and copy same_as_urls into the author page under
books/authors/.
Tell the user what was created and flag remaining manual steps:
image path.