Visit the interactive documentation at: https://dmccreary.github.io/claude-skills/

Claude Skills for Intelligent Textbooks is a comprehensive collection of AI-powered skills and workflows designed to revolutionize educational content creation. Built with Claude AI and optimized for intelligent textbook development, this repository provides educators and content creators with powerful tools to generate interactive, standards-based educational materials at scale.

This project enables the creation of Level 2+ intelligent textbooks using MkDocs with the Material theme, incorporating learning graphs, concept dependencies, 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 to ensure proper prerequisite sequencing.

Whether you're an educator building course materials, a technical writer creating documentation, or a developer interested in educational technology, these Claude skills provide a systematic, AI-powered approach to creating comprehensive, interactive educational content. The skills can generate everything from foundational learning graphs with 200+ concepts to interactive quizzes, glossaries, FAQs, and engaging simulations—all following rigorous quality standards.

Completion Status: Approximately 90% complete (content generation and skill development phase)

Skills Available: 19 specialized skills covering learning graphs, content generation, interactive visualizations, and educational assessments.

• Python 3.8 or higher
• Git
• Basic familiarity with markdown and command line

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

This project uses MkDocs with the Material theme:

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

Build the documentation site:

mkdocs build

Serve locally for development (with live reload):

mkdocs serve

Open your browser to http://localhost:8000

mkdocs gh-deploy

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

Option 1: Global Installation (All Projects)

Create symlinks to make skills available globally:

cd scripts
./install-claude-skills.sh

This installs skills to ~/.claude/skills/ for use across all Claude Code projects.

Option 2: Project-Specific Installation

Skills in this repository are automatically available when working within this project directory.

Invoke a skill in Claude Code:

Use the learning-graph-generator skill to create a concept graph for my course

Or use the slash command:

/skill learning-graph-generator

List available skills:

./scripts/list-skills.sh

Navigation:

• Use the left sidebar to browse chapters and skill descriptions
• Click the search icon (🔍) to search all content
• Each chapter includes quizzes for self-assessment
• The Learning Graph section shows concept dependencies and quality metrics

Interactive MicroSims:

• Found 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

claude-skills/
├── docs/                          # MkDocs documentation source
│   ├── chapters/                  # 13 chapters on intelligent textbook creation
│   │   ├── 01-intro-ai-intelligent-textbooks/
│   │   │   ├── index.md          # Chapter content
│   │   │   └── quiz.md           # Chapter quiz (40 questions)
│   │   └── ...
│   ├── sims/                      # Interactive p5.js MicroSims
│   │   ├── graph-viewer/         # Learning graph visualization
│   │   │   ├── main.html         # Standalone simulation
│   │   │   └── index.md          # Documentation
│   │   └── ...
│   ├── learning-graph/            # Learning graph data and analysis
│   │   ├── concept-list.md       # 200 concepts enumerated
│   │   ├── learning-graph.csv    # Concept dependencies (DAG)
│   │   ├── learning-graph.json   # vis-network JSON format
│   │   ├── quality-metrics.md    # Graph quality analysis
│   │   └── taxonomy-distribution.md
│   ├── skill-descriptions/        # Documentation for each skill
│   ├── prompts/                   # Example prompts for skill usage
│   ├── glossary.md                # ISO 11179-compliant definitions (200 terms)
│   ├── faq.md                     # Frequently asked questions (64 Q&A)
│   └── references.md              # Curated references (30 sources)
├── skills/                        # Claude AI skill definitions
│   ├── learning-graph-generator/
│   │   ├── SKILL.md               # Skill definition and workflow
│   │   ├── analyze-graph.py       # DAG validation script
│   │   ├── csv-to-json.py         # Convert to vis-network format
│   │   └── taxonomy-distribution.py
│   ├── glossary-generator/        # Generates ISO 11179 glossaries
│   ├── quiz-generator/            # Creates Bloom's Taxonomy quizzes
│   ├── faq-generator/             # Builds comprehensive FAQs
│   ├── microsim-p5/               # Creates p5.js simulations
│   ├── readme-generator/          # Generates README files
│   └── ...                        # 19 total skills
├── scripts/                       # Utility scripts
│   ├── install-claude-skills.sh   # Install skills globally
│   ├── list-skills.sh             # List available skills
│   └── list-skills-format.sh      # Format skill list (JSON, CSV)
├── commands/                      # Slash commands
│   └── skills.md                  # /skills command
├── mkdocs.yml                     # MkDocs configuration
├── CLAUDE.md                      # Instructions for Claude Code
└── README.md                      # This file

Found a bug, typo, or have a suggestion for improvement? Please report it:

GitHub Issues

When reporting issues, please include:

• Clear description of the problem or suggestion
• Steps to reproduce (for bugs)
• Expected vs actual behavior
• Screenshots or error messages (if applicable)
• Skill name and version (if skill-specific)
• Browser/environment details (for MicroSim issues)

This work is licensed under the Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.

You are free to:

• Share — Copy and redistribute the material in any medium or format
• Adapt — Remix, transform, and build upon the material

Under the following terms:

• Attribution — Give appropriate credit with a link to the original repository
• NonCommercial — No commercial use without explicit permission
• ShareAlike — Distribute your contributions under the same license

Attribution Example:

This work is based on "Claude Skills for Intelligent Textbooks" by Dan McCreary,
available at https://github.com/dmccreary/claude-skills, licensed under CC BY-NC-SA 4.0.

See license details for the full legal text.

This project is built on the shoulders of giants in the open source community. We are deeply grateful to:

• MkDocs - Fast, simple static site generator optimized for project documentation
• Material for MkDocs - Beautiful, responsive Material Design theme with advanced features

• p5.js - Creative coding library from NYU ITP for interactive educational simulations
• vis-network - Network visualization library for learning graph exploration
• Chart.js - Interactive charts for data visualization
• Mermaid - Diagram and flowchart generation from text

• Python community - Data processing, analysis, and automation tools
• PyMdown Extensions - Enhanced Markdown extensions

• Claude AI by Anthropic - Advanced AI assistant powering content generation and skill workflows
• Claude Code - AI-powered coding assistant enabling autonomous skill execution

• GitHub Pages - Free hosting for open source documentation projects
• GitHub - Version control and collaboration platform

• Raspberry Pi Pico - Affordable microcontroller platform
• MicroPython - Python 3 for microcontrollers
• NeoPixel by Adafruit - Addressable RGB LED technology

• Bloom's Taxonomy - Framework for categorizing cognitive learning objectives
• ISO 11179 - International standard for metadata registries (glossary definitions)
• Dublin Core - Metadata standards for educational resources

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.

Dan McCreary

• LinkedIn: linkedin.com/in/danmccreary
• GitHub: @dmccreary

Questions, suggestions, or collaboration opportunities? Feel free to connect on LinkedIn or open an issue on GitHub. I'm particularly interested in:

• Feedback on skill effectiveness and quality
• Suggestions for new skills or features
• Collaboration on educational technology projects
• Use cases and success stories from educators

If you use these Claude skills in your research, teaching, or projects, please cite:

McCreary, D. (2024). Claude Skills for Intelligent Textbooks. GitHub.
https://github.com/dmccreary/claude-skills

BibTeX:

@misc{mccreary2024claudeskills,
  author = {McCreary, Dan},
  title = {Claude Skills for Intelligent Textbooks},
  year = {2024},
  publisher = {GitHub},
  url = {https://github.com/dmccreary/claude-skills},
  note = {A collection of AI-powered skills for creating intelligent educational content}
}

This repository includes 19 specialized skills for intelligent textbook creation:

1. course-description-analyzer - Validates and enhances course descriptions
2. learning-graph-generator - Creates 200-concept dependency graphs (DAG structure)
3. book-chapter-generator - Designs optimal chapter structure from learning graphs
4. chapter-content-generator - Generates comprehensive chapter content with examples
5. glossary-generator - Creates ISO 11179-compliant glossaries
6. faq-generator - Generates FAQs from course content and learning graphs
7. quiz-generator - Creates Bloom's Taxonomy-aligned assessments
8. reference-generator - Curates academic references by education level

9. microsim-p5 - Creates educational p5.js simulations with interactive controls
10. microsim-standardization - Validates and upgrades MicroSim quality
11. bubble-chart-generator - Creates Chart.js bubble visualizations for priority matrices
12. timeline-generator - Generates interactive timeline visualizations
13. mermaid-generator - Creates workflow diagrams and flowcharts
14. venn-diagram-generator - Generates interactive Venn diagrams
15. vis-network - Creates network visualizations and graph explorers

16. intelligent-textbook - Complete 12-step textbook generation workflow
17. intelligent-textbook-creator - Creates MkDocs Material textbook projects
18. install-learning-graph-viewer - Installs interactive graph exploration tools
19. readme-generator - Generates comprehensive README files (this skill!)

For detailed documentation on each skill, see the skill descriptions in the documentation site.

Built with Claude Code | Powered by Claude AI | Open Educational Resources