dmccreary Book Publisher
Version: 1.0
Overview
This meta-skill handles publishing and promotion tasks for finished (or milestone-ready) intelligent textbooks. It consolidates four skills into a single entry point with on-demand loading of specific guides.
All four routes draw their numbers from the same canonical metrics hub — docs/learning-graph/book-metrics.json, produced by bk-generate-book-metrics (book-installer feature #40) — so the README, posts, carousel, and press release always cite identical statistics. Never recount content by hand or parse the human-readable book-metrics.md table.
When to Use This Skill
Use this skill when users request:
- Creating or updating the GitHub README (badges, overview, site metrics, getting started)
- Announcing a textbook milestone on LinkedIn (post text)
- Building a LinkedIn carousel / document post (13-slide PPTX/PDF with screenshots)
- Writing an AP-style press release for journalists or education trade press
Step 1: Identify Publishing Task
Routing Table
| Trigger Keywords | Guide File | Purpose |
|---|---|---|
| readme, github readme, update the readme, badges, repo documentation | references/readme-guide.md |
Create/update README.md with badges, overview, metrics table, getting-started |
| linkedin post, linkedin announcement, announce the book, milestone post, social media announcement | references/linkedin-post-guide.md |
Generate LinkedIn post text with metrics, hashtags, and link strategy |
| linkedin carousel, document post, carousel post, slideshow post, pptx for linkedin | references/linkedin-carousel-guide.md |
Generate a 13-slide PPTX/PDF carousel with real screenshots and metrics |
| press release, media pitch, journalists, news release, AP style, education press | references/press-release-guide.md |
Write an AP-style press release with headline, lead, quotes, boilerplate |
Decision Tree
GitHub repository documentation (README, badges)?
→ YES: readme-guide.md
Social announcement as TEXT (a LinkedIn post)?
→ YES: linkedin-post-guide.md
Social announcement as a SLIDESHOW (LinkedIn document post, PPTX/PDF)?
→ YES: linkedin-carousel-guide.md
(Post caption text for it → linkedin-post-guide.md; the two are often paired)
Formal news announcement for journalists / trade press?
→ YES: press-release-guide.md
Step 2: Ensure the Metrics Hub Is Fresh
Before any route, verify the canonical metrics file exists and is current:
bk-generate-book-metrics 2>/dev/null \
|| python3 "$BK_HOME/src/book-metrics/book-metrics.py" docs
Then read docs/learning-graph/book-metrics.json (the metrics object). If the script is unavailable, load $BK_HOME/skills/book-installer/references/book-metrics.md (feature #40) for the full setup.
Step 3: Load the Matched Guide
Read the corresponding guide file from references/ and follow its workflow.
Supporting Files
references/badges.md— shields.io badge catalog for the READMEreferences/carousel-slide-patterns.md— nine reusable pptxgenjs slide patternsreferences/carousel-content-sourcing.md— which project field feeds which carousel slidescripts/collect-site-metrics.py— fallback scanner for counts the metrics hub does not provide (image assets, code blocks)scripts/validate-readme.py— README structure validatorscripts/crop-screenshot.py— crop screenshots to carousel aspect ratio
Examples
Example 1: README
User: "Update the README for this book"
Routing: Keyword "README" → references/readme-guide.md
Action: Refresh book-metrics.json, read readme-guide.md, generate README.md with badges and metrics table
Example 2: LinkedIn Post
User: "Write a LinkedIn announcement — we just published chapter 12"
Routing: Keywords "LinkedIn announcement" → references/linkedin-post-guide.md
Action: Read linkedin-post-guide.md; pull metrics from book-metrics.json; produce post text + hashtags
Example 3: Carousel
User: "Make a LinkedIn carousel showing off the book's features"
Routing: Keyword "carousel" → references/linkedin-carousel-guide.md
Action: Read linkedin-carousel-guide.md; capture/crop screenshots; build the 13-slide PPTX
Example 4: Press Release
User: "Write a press release for the course launch"
Routing: Keywords "press release" → references/press-release-guide.md
Action: Read press-release-guide.md; verify 2-3 figures from book-metrics.json; write AP-style release