Skip to content
Back to search

claude-skills

SkillWorks with Claude CodeGitHub

Agent Skills for Intelligent Textbooks

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/dmccreary--claude-skills/badge.svg)](/listings/dmccreary--claude-skills)

HTML

<a href="/listings/dmccreary--claude-skills"><img src="/api/listings/dmccreary--claude-skills/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Prerequisites

- Python 3.8 or higher - Git - An AI coding agent that supports agent skills or a similar convention (e.g. Claude Code, OpenAI Codex, Google Antigravity, Cursor) - Basic familiarity with markdown and the command line

Clone the Repository

git clone https://github.com/dmccreary/ibook-skills.git
cd ibook-skills

Install Dependencies

This project uses MkDocs with the Material theme:

pip install mkdocs
pip install mkdocs-material
pip install pymdown-extensions

Build and Serve Locally

Build the documentation site:

mkdocs build

Serve locally for development (with live reload):

mkdocs serve

Open your browser to `http://localhost:8000`

Deploy to GitHub Pages

mkdocs gh-deploy

This will build the site and push it to the `gh-pages` branch.

Installing the Skills for Your Agent

Set `BK_HOME` to the repository root, then run the installer for your platform:

export BK_HOME="$HOME/path/to/ibook-skills"

# Every agent present on this machine
$BK_HOME/scripts/bk-install-skills

# Or narrow it
$BK_HOME/scripts/bk-install-skills --only codex
$BK_HOME/scripts/bk-install-skills --list      # show agents and status
$BK_HOME/scripts/bk-install-skills --dry-run   # preview, change nothing

The script symlinks every active skill in `skills/` (any directory with a `SKILL.md`, which excludes `skills/archived/`) into the skills directory of each supported agent — Claude Code, OpenAI Codex, and Google Antigravity. Edits to a skill here are picked up immediately by every connected agent.

It installs to **all** agents by default rather than detecting the caller: the three are often used together, so a per-agent install silently leaves the others on a stale skill set. Agents that aren't installed on the machine are skipped; `--all` forces their directories to be created.

**List available skills:**

$BK_HOME/scripts/bk-list-skills

**Invoking a skill:** most agents pick up a skill automatically once the task matches its description. Where a tool supports explicit invocation, reference it by name, e.g. `Use the learning-graph-generator skill to create a concept graph for my course`.

Using the Documentation Site

**Navigation:**

- Use the left sidebar to browse chapters and skill descriptions - Click the search icon (🔍) to search all content - The Learning Graph section shows concept dependencies and quality metrics

**Interactive MicroSims:**

- Found throughout the chapters and in the "MicroSims" section of the documentation - Each simulation runs standalone in your browser - Adjust parameters with sliders and interactive controls - View source code and customize for your own use

**Customization:**

- Edit markdown files in `docs/` to modify content - Modify `mkdocs.yml` to change site structure and navigation - Add your own MicroSims in `docs/sims/[microsim-name]/` - Customize theme colors and styles in `docs/css/extra.css` - Create custom skills in `skills/[skill-name]/SKILL.md`

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 326 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Agent Skills for Intelligent Textbooks
  2. [![MkDocs](https://img.shields.io/badge/Made%20with-MkDocs-526CFE?logo=materialformkdocs)](https://www.mkdocs.org/)
  3. [![Material for MkDocs](https://img.shields.io/badge/Material%20for%20MkDocs-526CFE?logo=materialformkdocs)](https://squidfunk.github.io/mkdocs-material/)
  4. [![GitHub Pages](https://img.shields.io/badge/View%20on-GitHub%20Pages-blue?logo=github)](https://dmccreary.github.io/ibook-skills/)
  5. [![Agent Skills](https://img.shields.io/badge/Agent%20Skills-Multi--Platform-4A90D9)](https://github.com/dmccreary/ibook-skills)
  6. [![p5.js](https://img.shields.io/badge/p5.js-ED225D?logo=p5.js&logoColor=white)](https://p5js.org/)
  7. [![Python](https://img.shields.io/badge/Python-3.8+-3776AB?logo=python&logoColor=white)](https://www.python.org/)
  8. [![License: CC BY-NC-SA 4.0](https://img.shields.io/badge/License-CC%20BY--NC--SA%204.0-lightgrey.svg)](https://creativecommons.org/licenses/by-nc-sa/4.0/)
  9. ## View the Live Site
  10. Visit the interactive documentation at: [https://dmccreary.github.io/ibook-skills/](https://dmccreary.github.io/ibook-skills/)
  11. ## Overview
  12. **Agent Skills for Intelligent Textbooks** is a portable, token-efficient library of AI agent skills for building interactive educational textbooks. The skills are written as plain-language markdown workflows (`SKILL.md` files), so they aren't locked to one vendor's assistant — the same skill set has been installed and run in **Claude Code, OpenAI Codex, Google Antigravity/Gemini, Cursor, Perplexity, and Hermes**. The repository's `CLAUDE.md` instructions file doubles as an `AGENTS.md` for tools that use that convention, and a single install script (`bk-install-skills`) symlinks the same skills into the skills directory of every agent present on the machine.
  13. This project enables the creation of **Level 2+ intelligent textbooks** using MkDocs with the Material theme, incorporating learning graphs, concept dependency mapping, interactive p5.js simulations (MicroSims), and AI-assisted content generation. Every skill follows educational best practices including Bloom's Taxonomy (2001 revision) for learning outcomes, ISO 11179 standards for terminology definitions, and concept dependency graphs (DAGs) to ensure prerequisites are taught before they're used.
  14. Whether you're an educator building course materials, a technical writer producing documentation, or a developer exploring educational technology, these agent skills provide a systematic, repeatable pipeline from a course description all the way to a published, interactive textbook — regardless of which AI coding agent you point at the repository.
  15. ## Site Status and Metrics
  16. | Metric | Count |
  17. |--------|-------|
  18. | Concepts in Learning Graph | 570 |
  19. | Chapters | 31 |
  20. | Appendices | 3 |
  21. | MicroSims | 94 |
  22. | Glossary Terms | 570 |
  23. | FAQ Questions | 66 |
  24. | Diagrams | 25 |
  25. | Equations | 131 |
  26. | Total Words | 154,857 |
  27. | Equivalent Pages | ~672 |
  28. Chapter-level quizzes and curated references are actively being generated and are not yet complete across all 31 chapters.
  29. **Skills Available:** 14 active skills (several are meta-skills that route to dozens of sub-workflows) covering learning graph generation, chapter content, MicroSims, glossaries, FAQs, quizzes, references, media, and publishing.
  30. ## Getting Started
  31. ### Prerequisites
  32. - Python 3.8 or higher
  33. - Git
  34. - An AI coding agent that supports agent skills or a similar convention (e.g. Claude Code, OpenAI Codex, Google Antigravity, Cursor)
  35. - Basic familiarity with markdown and the command line
  36. ### Clone the Repository
  37. ```bash
  38. git clone https://github.com/dmccreary/ibook-skills.git
  39. cd ibook-skills
  40. ```
  41. ### Install Dependencies
  42. This project uses MkDocs with the Material theme:
  43. ```bash
  44. pip install mkdocs
  45. pip install mkdocs-material
  46. pip install pymdown-extensions
  47. ```
  48. ### Build and Serve Locally
  49. Build the documentation site:
  50. ```bash
  51. mkdocs build
  52. ```
  53. Serve locally for development (with live reload):
  54. ```bash
  55. mkdocs serve
  56. ```
  57. Open your browser to `http://localhost:8000`
  58. ### Deploy to GitHub Pages
  59. ```bash
  60. mkdocs gh-deploy
  61. ```
  62. This will build the site and push it to the `gh-pages` branch.
  63. ### Installing the Skills for Your Agent
  64. Set `BK_HOME` to the repository root, then run the installer for your platform:
  65. ```bash
  66. export BK_HOME="$HOME/path/to/ibook-skills"
  67. # Every agent present on this machine
  68. $BK_HOME/scripts/bk-install-skills
  69. # Or narrow it
  70. $BK_HOME/scripts/bk-install-skills --only codex
  71. $BK_HOME/scripts/bk-install-skills --list # show agents and status
  72. $BK_HOME/scripts/bk-install-skills --dry-run # preview, change nothing
  73. ```
  74. The script symlinks every active skill in `skills/` (any directory with a `SKILL.md`, which excludes `skills/archived/`) into the skills directory of each supported agent — Claude Code, OpenAI Codex, and Google Antigravity. Edits to a skill here are picked up immediately by every connected agent.
  75. It installs to **all** agents by default rather than detecting the caller: the three are often used together, so a per-agent install silently leaves the others on a stale skill set. Agents that aren't installed on the machine are skipped; `--all` forces their directories to be created.
  76. **List available skills:**
  77. ```bash
  78. $BK_HOME/scripts/bk-list-skills
  79. ```
  80. **Invoking a skill:** most agents pick up a skill automatically once the task matches its description. Where a tool supports explicit invocation, reference it by name, e.g. `Use the learning-graph-generator skill to create a concept graph for my course`.
  81. ### Using the Documentation Site
  82. **Navigation:**
  83. - Use the left sidebar to browse chapters and skill descriptions
  84. - Click the search icon (🔍) to search all content
  85. - The Learning Graph section shows concept dependencies and quality metrics
  86. **Interactive MicroSims:**
  87. - Found throughout the chapters and in the "MicroSims" section of the documentation
  88. - Each simulation runs standalone in your browser
  89. - Adjust parameters with sliders and interactive controls
  90. - View source code and customize for your own use
  91. **Customization:**
  92. - Edit markdown files in `docs/` to modify content
  93. - Modify `mkdocs.yml` to change site structure and navigation
  94. - Add your own MicroSims in `docs/sims/[microsim-name]/`
  95. - Customize theme colors and styles in `docs/css/extra.css`
  96. - Create custom skills in `skills/[skill-name]/SKILL.md`
  97. ## Repository Structure
  98. ```
  99. ibook-skills/
  100. ├── docs/ # MkDocs documentation source
  101. │ ├── chapters/ # 31 chapters + appendices on building intelligent textbooks
  102. │ │ ├── 01-foundations-ai-language-models/
  103. │ │ │ └── index.md # Chapter content
  104. │ │ └── ...
  105. │ ├── sims/ # 94 interactive MicroSims (p5.js, Chart.js, vis-network, ...)
  106. │ ├── learning-graph/ # Learning graph data, analysis, and book metrics
  107. │ │ ├── concept-list.md # 570 concepts enumerated
  108. │ │ ├── learning-graph.csv # Concept dependencies (DAG)
  109. │ │ ├── learning-graph.json # vis-network JSON format
  110. │ │ ├── book-metrics.json # Canonical book-wide metrics (source of truth)
  111. │ │ └── quality-metrics.md # Graph quality analysis
  112. │ ├── glossary.md # ISO 11179-compliant definitions (570 terms)
  113. │ └── faq.md # Frequently asked questions (66 Q&A)
  114. ├── skills/ # AI agent skill definitions
  115. │ ├── learning-graph-generator/ # Generates 300-600 concept dependency graphs
  116. │ ├── book-chapter-generator/ # Designs chapter structure from the learning graph
  117. │ ├── chapter-content-generator/ # Generates chapter content and MicroSims
  118. │ ├── glossary-generator/ # ISO 11179-compliant glossary
  119. │ ├── faq-generator/ # FAQs from chapter content
  120. │ ├── quiz-generator/ # Bloom's Taxonomy-aligned quizzes
  121. │ ├── reference-generator/ # Curated per-chapter references
  122. │ ├── microsim-generator/ # MicroSims across many JS libraries (meta-skill)
  123. │ ├── microsim-utils/ # MicroSim QA and maintenance (meta-skill)
  124. │ ├── book-installer/ # Project scaffold and infrastructure (meta-skill)
  125. │ ├── book-media-generator/ # Slides, illustrations, audio (meta-skill)
  126. │ ├── book-publisher/ # README, LinkedIn, press release (meta-skill)
  127. │ └── archived/ # Original single-purpose skills, consolidated into the meta-skills above
  128. ├── scripts/ # Utility scripts (install, metrics, screenshots, ...)
  129. │ ├── bk-install-skills # Install skills for every agent present
  130. │ ├── bk-install-skills-codex # Deprecated shim -> --only codex
  131. │ ├── bk-install-skills-antigravity # Deprecated shim -> --only antigravity
  132. │ └── bk-list-skills # List all active skills
  133. ├── commands/ # Slash commands
  134. ├── mkdocs.yml # MkDocs configuration
  135. ├── CLAUDE.md # Agent instructions (also usable as AGENTS.md)
  136. └── README.md # This file
  137. ```
  138. ## Reporting Issues
  139. Found a bug, typo, or have a suggestion for improvement? Please report it:
  140. [GitHub Issues](https://github.com/dmccreary/ibook-skills/issues)
  141. When reporting issues, please include:
  142. - Clear description of the problem or suggestion
  143. - Steps to reproduce (for bugs)
  144. - Expected vs actual behavior
  145. - Screenshots or error messages (if applicable)
  146. - Skill name and the AI agent/tool you were using (if skill-specific)
  147. - Browser/environment details (for MicroSim issues)
  148. ## License
  149. This work is licensed under the [Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License](https://creativecommons.org/licenses/by-nc-sa/4.0/).
  150. **You are free to:**
  151. - **Share** — Copy and redistribute the material in any medium or format
  152. - **Adapt** — Remix, transform, and build upon the material
  153. **Under the following terms:**
  154. - **Attribution** — Give appropriate credit with a link to the original repository
  155. - **NonCommercial** — No commercial use without explicit permission
  156. - **ShareAlike** — Distribute your contributions under the same license
  157. **Attribution Example:**
  158. ```
  159. This work is based on "Agent Skills for Intelligent Textbooks" by Dan McCreary,
  160. available at https://github.com/dmccreary/ibook-skills, licensed under CC BY-NC-SA 4.0.
  161. ```
  162. See [license details](docs/license.md) for the full legal text.
  163. ## Acknowledgements
  164. This project is built on the shoulders of giants in the open source community. We are deeply grateful to:
  165. ### Documentation and Build Tools
  166. - **[MkDocs](https://www.mkdocs.org/)** - Fast, simple static site generator optimized for project documentation
  167. - **[Material for MkDocs](https://squidfunk.github.io/mkdocs-material/)** - Beautiful, responsive Material Design theme with advanced features
  168. ### Interactive Visualizations and Creative Coding
  169. - **[p5.js](https://p5js.org/)** - Creative coding library from NYU ITP for interactive educational simulations
  170. - **[vis-network](https://visjs.org/)** - Network visualization library for learning graph exploration
  171. - **[Chart.js](https://www.chartjs.org/)** - Interactive charts for data visualization
  172. - **[Mermaid](https://mermaid.js.org/)** - Diagram and flowchart generation from text
  173. ### Python Ecosystem
  174. - **[Python](https://www.python.org/)** community - Data processing, analysis, and automation tools
  175. - **[PyMdown Extensions](https://facelessuser.github.io/pymdown-extensions/)** - Enhanced Markdown extensions
  176. ### Hosting and Deployment
  177. - **[GitHub Pages](https://pages.github.com/)** - Free hosting for open source documentation projects
  178. - **[GitHub](https://github.com/)** - Version control and collaboration platform
  179. ### Educational Standards and Frameworks
  180. - **[Bloom's Taxonomy](https://en.wikipedia.org/wiki/Bloom%27s_taxonomy)** - Framework for categorizing cognitive learning objectives
  181. - **[ISO 11179](https://www.iso.org/standard/50340.html)** - International standard for metadata registries (glossary definitions)
  182. - **[Dublin Core](https://www.dublincore.org/)** - Metadata standards for educational resources
  183. Special thanks to the educators, developers, and maintainers who contribute to making educational resources accessible, interactive, and open to all. Your work enables projects like this to exist and thrive.
  184. ## Contact
  185. **Dan McCreary**
  186. - LinkedIn: [linkedin.com/in/danmccreary](https://www.linkedin.com/in/danmccreary/)
  187. - GitHub: [@dmccreary](https://github.com/dmccreary)
  188. Questions, suggestions, or collaboration opportunities? Feel free to connect on LinkedIn or open an issue on GitHub. I'm particularly interested in:
  189. - Feedback on skill effectiveness and quality across different AI agents
  190. - Suggestions for new skills or features
  191. - Collaboration on educational technology projects
  192. - Use cases and success stories from educators
  193. ## How to Cite
  194. If you use these agent skills in your research, teaching, or projects, please cite:
  195. ```
  196. McCreary, D. (2024). Agent Skills for Intelligent Textbooks. GitHub.
  197. https://github.com/dmccreary/ibook-skills
  198. ```
  199. **BibTeX:**
  200. ```bibtex
  201. @misc{mccreary2024agentskills,
  202. author = {McCreary, Dan},
  203. title = {Agent Skills for Intelligent Textbooks},
  204. year = {2024},
  205. publisher = {GitHub},
  206. url = {https://github.com/dmccreary/ibook-skills},
  207. note = {A portable, multi-platform library of AI agent skills for creating intelligent educational content}
  208. }
  209. ```
  210. ## Available Skills
  211. This repository includes 14 active skills for intelligent textbook creation. Several are meta-skills that route to focused sub-workflows in a `references/` folder, which keeps the total under each platform's loaded-skills limit while still covering dozens of tasks.
  212. ### Content-Pipeline Skills
  213. 1. **course-description-analyzer** - Validates and enhances course descriptions
  214. 2. **learning-graph-generator** - Creates 300-600 concept dependency graphs (DAG structure)
  215. 3. **book-chapter-generator** - Designs chapter structure from the learning graph
  216. 4. **chapter-content-generator** - Generates chapter content, diagrams, and exercises
  217. 5. **glossary-generator** - Creates ISO 11179-compliant glossaries
  218. 6. **faq-generator** - Generates FAQs from chapter content and the learning graph
  219. 7. **quiz-generator** - Creates Bloom's Taxonomy-aligned quiz questions
  220. 8. **reference-generator** - Curates per-chapter academic references
  221. ### Meta-Skills (Routers)
  222. 9. **book-installer** - Project scaffolding and infrastructure: init a new textbook, install features (math, mascot, learning-graph viewer, Google Analytics, and more), generate book metrics
  223. 10. **microsim-generator** - MicroSims across p5.js, Chart.js, Plotly, Mermaid, vis-network, timelines, maps, and more
  224. 11. **microsim-utils** - MicroSim QA: standardization, screenshots, layout review, coverage reports
  225. 12. **book-media-generator** - Slide decks, illustrated stories, chapter images, and audio
  226. 13. **book-publisher** - README, LinkedIn posts/carousels, and press releases
  227. ### Standalone
  228. 14. **docx-to-web-publisher** - Converts .docx files into structured web pages
  229. For detailed documentation on each skill, see the [skill descriptions](https://dmccreary.github.io/ibook-skills/skill-descriptions/) in the documentation site.
  230. ---
  231. **Portable Agent Skills** | **Works with Claude Code, Codex, Antigravity/Gemini, Cursor, Perplexity, and Hermes** | **Open Educational Resources**

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.