# Book Metrics Generator

> The book-metrics-generator skill automates the generation of comprehensive metrics for intelligent textbooks.

- Skill: `tools-only/book-metrics-generator-2` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add tools-only/book-metrics-generator-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tools-only/book-metrics-generator-2/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tools-only (https://skillmd.com/u/tools-only)
- Updated: 2026-09-29
- Page: https://skillmd.com/skills/tools-only/book-metrics-generator-2

---

# Book Metrics Generator

The book-metrics-generator skill automates the generation of comprehensive metrics
for intelligent textbooks. It analyzes the entire textbook structure and content
to produce detailed quantitative reports for tracking progress and identifying
areas needing attention.

## Key Capabilities

This skill generates two report files in the `docs/learning-graph/` directory:

1. **book-metrics.md** - Overall book statistics with links to relevant sections
2. **chapter-metrics.md** - Chapter-by-chapter breakdown in tabular format

## Metrics Analyzed

The skill analyzes and reports on:

- **Content Volume**: Word counts, page equivalents, chapter counts
- **Educational Components**: Concepts covered, glossary terms, FAQ entries
- **Assessment Elements**: Quiz questions by chapter and Bloom's level
- **Interactive Elements**: MicroSims, diagrams, equations
- **Navigation**: Internal links, external references

## When to Use

Use this skill when:

- Tracking progress on intelligent textbook development
- Preparing status reports for stakeholders
- Assessing content completeness before publication
- Analyzing distribution of educational elements across chapters
- Estimating physical page equivalent of digital content
- Comparing metrics over time to track growth

## Prerequisites

The intelligent textbook project should have:

- A `docs/` directory containing the textbook content
- Chapters in `docs/chapters/` following numbered naming convention
- Standard MkDocs Material structure

## Output Example

The book-metrics.md file includes sections for:

- Summary statistics with links
- Content breakdown by type
- Chapter-by-chapter comparison table
- Visualization recommendations

## Shell Script Access

For efficiency, the skill can also be run directly via shell script:

```bash
~/.claude/skills/book-metrics-generator/scripts/book-metrics-generator.sh
```

## Integration

This skill is typically used after significant content development or as part of
regular project status reporting. It works with any MkDocs Material-based
intelligent textbook following the standard structure.