book-metrics-generator

Generate markdown metrics reports for MkDocs Material textbooks.

Updated Jul 5, 2026
One-click install
npx skills add https://github.com/archerli/skill-set --skill book-metrics-generator-archerli
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: book-metrics-generator
Source: https://github.com/archerli/skill-set/tree/main/baoyu-skills/book-metrics-generator
Command: npx skills add https://github.com/archerli/skill-set --skill book-metrics-generator-archerli

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python3, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the generation of comprehensive metrics for intelligent textbooks, providing quantitative insights into content volume, educational components, and interactive elements.

Core Features & Use Cases

  • Comprehensive Metrics: Analyzes chapters, concepts, glossary terms, FAQs, quiz questions, diagrams, equations, MicroSims, word counts, and links.
  • Custom Reports: Generates two markdown files - book-metrics.md with overall statistics and chapter-metrics.md with per-chapter breakdowns.
  • Use Case: Ideal for intelligent textbook projects that require quantitative analysis of content, typically after significant content development or for project status reporting.

Quick Start

Run the following command in your terminal to generate metrics for your textbook project:

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

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 content metrics for an MkDocs intelligent textbook?

Generate content metrics for an MkDocs intelligent textbook by running the provided shell script in your terminal. It automatically analyzes chapters, concepts, glossary terms, and quizzes, outputting two markdown files with overall and per-chapter statistics.

What textbook elements can I automatically analyze for project status reporting?

You can automatically analyze textbook elements including chapters, concepts, glossary terms, FAQs, quiz questions, diagrams, equations, MicroSims, word counts, and links. This provides quantitative insights into content volume and interactive educational components for status reporting.

Do I need Python 3 to analyze MkDocs Material textbook content?

Yes, you need Python 3 installed to run the analysis script. Additionally, your project must use an MkDocs Material-based intelligent textbook structure to ensure the script can accurately parse and evaluate the educational content.

What format are the generated textbook content analysis reports saved in?

The generated textbook content analysis reports are saved as two markdown files: book-metrics.md for overall statistics and chapter-metrics.md for per-chapter breakdowns. These files document quantitative insights into the analyzed content.

When should I run an automated content analysis on my textbook project?

You should run automated content analysis on your textbook project after significant content development or when you need project status reporting. It provides quantitative insights into content volume, educational components, and interactive elements.