harness-book-best-practice

Apply Harness book workflow best practices for editing, building, and exporting.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/adminlove520/Claude-Code-Universe --skill harness-book-best-practice
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: harness-book-best-practice
Source: https://github.com/adminlove520/Claude-Code-Universe/tree/main/harness-books/.codex/skills/harness-book-best-practice
Command: npx skills add https://github.com/adminlove520/Claude-Code-Universe --skill harness-book-best-practice

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Best practices for Harness books repo and workflow. Use this skill when editing, restructuring, building, or exporting the Harness books in book1-claude-code/ and book2-comparing/, ensuring Honkit navigation, HTML/print HTML exports, Pandoc/XeLaTeX PDF export, build cleanup, TOC stability, naming conventions, and keeping source assets separate from generated outputs.

Core Features & Use Cases

  • Ensure consistent book structure, tooling usage, and release discipline across both books.
  • Guide engineering and documentation teams through editing, building, exporting, and publishing workflows with shared tooling.
  • Use Case: Before making a major reorganization of book1-claude-code, apply the skill to align the process, tooling, and metadata, preventing drift.

Quick Start

Review the Harness book best-practice guidelines and apply the shared tooling from tools/book-kit when editing or exporting books.

Frequently Asked Questions about harness-book-best-practice

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

FAQPage Schema
How do I export Honkit documentation to PDF using Pandoc and XeLaTeX?

To export Honkit books to PDF, apply the shared tooling from tools/book-kit to run Pandoc and XeLaTeX, ensuring source assets remain separate from generated outputs. This workflow enforces consistent release metadata and proper build cleanup.

What's the best way to fix table of contents navigation issues in Honkit books?

Fixing TOC issues in Honkit requires applying TOC stability best practices during editing and restructuring. Use the shared book-kit tooling to enforce naming conventions and maintain consistent navigation structure across book1-claude-code and book2-comparing.

How do I keep source assets separate from generated HTML exports in a documentation workflow?

Keeping source assets separate from generated HTML exports involves using shared tooling under tools/book-kit. This documentation workflow enforces build cleanup and consistent release metadata management to prevent drift between source files and print HTML outputs.

Can I use Pandoc and XeLaTeX for PDF export without breaking Honkit navigation?

Pandoc and XeLaTeX PDF export works with Honkit navigation when applying shared book best-practice workflows. The tools/book-kit ensures TOC stability and proper build cleanup, maintaining consistent book structure throughout the export process.

Why does my Honkit book build fail after restructuring chapters?

Honkit book builds fail after restructuring due to TOC instability and naming convention drift. Apply the book best-practice workflow to align process, tooling, and metadata, preventing structural inconsistencies across book1-claude-code and book2-comparing.

Do I need to install tools/book-kit before editing Harness books?

Yes, tools/book-kit provides shared tooling required before editing Harness books. This prerequisite environment setup ensures consistent book structure, proper HTML and PDF export workflows, and release discipline across both book repositories.