book-companion-skill
Create companion Codex workflows from book chapters, reader exercises, prompts, field notes, and teaching material. Use when Codex needs to turn a chapter excerpt, 書籍練習, AI 提示詞, worksheet, or author note into a reusable Skill-style workflow, GitHub-shareable companion artifact, or book link resource for readers.
npx skills add twhsi/skills --skill book-companion-skill --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Book Companion Skill ## Overview Convert book material into a reader-friendly, executable Codex workflow. Preserve the author's voice, make the task usable by someone who only has the book in front of them, and produce artifacts that can be shared through GitHub or linked from a printed/e-book chapter. ## Workflow 1. Identify the source material: - Book title or working title - Chapter or section - Reader goal - Raw exercise, prompt, note, or example - Expected output format, if provided 2. Decide the artifact type: - **Reader prompt**: A short prompt readers can paste into Codex or ChatGPT. - **Skill draft**: A `SKILL.md` workflow for repeatable use. - **Chapter companion card**: A compact Markdown card for a GitHub README, QR landing page, or book appendix. - **Exercise upgrade**: A clearer, more testable version of a chapter exercise. 3. Translate the book material into action: - Keep the reader's first step obvious. - State what input the reader should provide. - State what Codex should produce. - Include constraints only when they materially improve the result. - Avoid assuming readers know internal author notes or private context. 4. Package the result for sharing: - Use st
- Overview
- Workflow
- Output Patterns
- Reader Prompt
- Skill Draft
- Chapter Companion Card
- Quality Bar
- References
What does the book-companion-skill skill do?
Create companion Codex workflows from book chapters, reader exercises, prompts, field notes, and teaching material. Use when Codex needs to turn a chapter excerpt, 書籍練習, AI 提示詞, worksheet, or author note into a reusable Skill-style workflow, GitHub-shareable companion artifact, or book link resource for readers.
How do I install it?
Run `npx skills add twhsi/skills --skill book-companion-skill --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From twhsi/skills, a repository with 256 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.
