Agent Skills for Intelligent Textbooks
A skill set for building interactive MkDocs textbooks: concept graph, chapters, simulations, quizzes and glossary.
- 111 ★ on the repository
- Last commit
Extended access
Why this level
- The installer creates symlinks in several agents' skill directories.
- Skills write files into the textbook project and can publish the site to GitHub Pages.
Install
- Works in
Manual install
git clone https://github.com/dmccreary/ibook-skills.gitThe first command of the getting-started section. Then `$BK_HOME/scripts/bk-install-skills` links skills into agent directories.
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The installer creates symlinks in several agents' skill directories.
- Skills write files into the textbook project and can publish the site to GitHub Pages.
This is third-party code. Review the repository files before installing.
What it does
ibook-skills turns a course description into a published interactive textbook. The skills lead the agent through a chain: course description analysis, a concept dependency graph, chapter text, glossary, FAQ, quizzes, references, media and publishing to GitHub Pages. Separate skills build p5.js micro-simulations, add xAPI events to them, and assemble arXiv papers and LinkedIn posts. They are plain markdown `SKILL.md` files, so they run in Claude Code, Codex, Antigravity, Cursor and other agents. The `bk-install-skills` script symlinks every skill into the directories of detected agents.
Who it is for. Teachers, instructional designers and technical writers building a textbook or course who want concepts introduced in dependency order.
Good fit when
- You have a 12-week course description and want a textbook with chapters.
- A topic needs interactive simulations that run right in the browser.
- A glossary of hundreds of terms must follow one definition standard.
- Chapter quizzes are tied to Bloom's taxonomy levels.
Not a fit when
- You need a single one-off summary: the skill chain is overkill.
- You need a ready learning platform with student accounts.
- The material will not be published as an MkDocs site.
Example request
Use the learning-graph-generator skill to build a concept graph for a Python basics course from this description.Limitations
The repository is both a textbook site and a skill library, so it holds many files irrelevant to installation; the skills live in the `skills/` directory. Setup goes through cloning, `pip install mkdocs mkdocs-material` and an install script with symlinks, not one command. GitHub detects no license file, while the README names CC BY-NC-SA 4.0 with a noncommercial restriction. Chapter quizzes and references are still being written, per the author. The script's symlinks tie the skills to the repository clone, so moving the folder breaks them.
How to disable. Use the installer's listing mode, remove the symlinks it created in the agents' skill directories, then delete the clone.
FAQ
Which skills are included?
About two dozen: concept graph, chapter generator, glossary, FAQ, quizzes, simulations, references, media, publishing and LinkedIn posts.
How do I install into several agents at once?
Run `bk-install-skills` with no flags: the script links skills into the Claude Code, Codex and Antigravity directories it finds on the machine.
Can I install for Codex only?
Yes, use `--only codex`. `--list` shows agents and status, and `--dry-run` changes nothing.
What is a micro-simulation?
A small interactive p5.js page embedded in a chapter: sliders change parameters and the result is visible in the browser.
Is MkDocs required?
For building the textbook site, yes: `pip install mkdocs mkdocs-material pymdown-extensions`, then `mkdocs serve` to preview.
Discussion
No questions or reviews yet.
Related
SkillsLearn from materials
learn-from-materials
A skill that turns books, PDFs, slides and documents into a traceable knowledge base and an interactive learning page with sources, maps and self-check
A set of 14 skills that teach the agent to build diagrams and visualizations right inside Markdown: UML, cloud and network schemes, charts, maps and cards
Turns a technical book or a folder of documents into a structured skill with chapters, a glossary and a cheatsheet
Education Agent Skills
education-agent-skills
165 evidence-based skills for teachers, school leaders and EdTech, installed locally with an optional self-hosted MCP server
Python CLI that compiles a book into an installable Agent Skill: a knowledge pack or a behavior skill with verbatim quote checks
16 ready skills for Cursor, Claude Code and Codex: theses, PDF and Office, draw.io diagrams, project documentation
README in short
The README explains the set's design, shows metrics of the reference textbook (31 chapters, 570 concepts, 94 simulations) and gives the skill install order.