book-metrics-generator

Compute book and chapter metrics from MkDocs textbook directories.

Updated Apr 21, 2026
One-click install
npx skills add https://github.com/HuuBar/skill-routing-experiment --skill book-metrics-generator-huubar
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: book-metrics-generator
Source: https://github.com/HuuBar/skill-routing-experiment/tree/main/unified_skills/vishal/book-metrics-generator
Command: npx skills add https://github.com/HuuBar/skill-routing-experiment --skill book-metrics-generator-huubar

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Large-scale intelligent textbooks often require ongoing metrics to measure progress, content density, and instructional quality. This skill automates the collection and reporting of key statistics across the entire book and per-chapter levels, enabling data-driven project management and publication readiness.

Core Features & Use Cases

  • Generates two markdown reports: book-metrics.md with overall statistics and chapter-metrics.md with chapter-level details.
  • Counts chapters, concepts, glossary terms, FAQs, quizzes, diagrams, equations, microsims, total words, and hyperlinks.
  • Writes outputs to docs/learning-graph and provides links for easy integration into MkDocs navigation and status reporting.
  • Use Cases: track content development, monitor coverage of learning elements, and prepare stakeholder reports.

Quick Start

Run the shell script from the skill root to generate book- and chapter-metrics.md in docs/learning-graph.

Frequently Asked Questions about book-metrics-generator

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate metrics for an MkDocs textbook?

To generate metrics for an MkDocs textbook, run the provided shell script from the skill root to analyze the docs directory and output book-metrics.md and chapter-metrics.md reports into docs/learning-graph.

What statistics are included in textbook content analysis reports?

Textbook content analysis reports include counts of chapters, concepts, glossary terms, FAQs, quizzes, diagrams, equations, microsims, total words, and hyperlinks to measure content density and instructional quality.

Can I use this tool to track learning graph progress for large-scale intelligent textbooks?

Yes, you can use this to track learning graph progress for large-scale intelligent textbooks by automating the collection of key statistics across overall book and per-chapter levels for data-driven project management.

Where are the generated textbook metrics reports saved?

The generated textbook metrics reports are saved to the docs/learning-graph directory, providing markdown files with easy integration into MkDocs navigation and status reporting.

Do I need any dependencies to count chapters and concepts in my textbook?

No dependencies are required to count chapters and concepts in your textbook; the skill operates using standalone scripts to analyze the MkDocs directory and generate the metrics reports.

Why use automated reporting for textbook publication readiness?

Automated reporting for textbook publication readiness monitors coverage of learning elements and content development progress, enabling stakeholders to prepare accurate data-driven reports without manual counting.