Extract Jobs-To-Be-Done records from Markdown, AsciiDoc, and topic map documentation repositories. Generate goal-oriented TOCs organized by user jobs and workflows. Compare feature-based vs JTBD structures with navigation metrics. Produce consolidation reports with gap analysis and stakeholder benefits for docs restructuring.
npx claudepluginhub redhat-documentation/redhat-docs-agent-tools --plugin jtbd-toolsExtract Jobs-To-Be-Done records from AsciiDoc documentation repos. Use when analyzing modular AsciiDoc docs (assemblies, includes, conditionals) for user goals and JTBD-oriented restructuring. Handles reduction, source mapping, and chunked analysis.
Extract Jobs-To-Be-Done records from OpenShift docs repos that use _topic_map.yml for structure instead of master.adoc. Parses the topic map to discover books and assemblies, reduces each assembly, and runs JTBD analysis.
Extract Jobs-To-Be-Done records from technical documentation using the methodology defined in [methodology.md](../../reference/methodology.md).
Generate a side-by-side comparison of current (feature-based) vs. proposed (JTBD-based) documentation structures.
Generate a consolidation report showing how JTBD restructuring improves documentation navigation. Use after running jtbd-analyze, jtbd-toc, and jtbd-compare to produce a stakeholder-facing summary with consolidation examples, gap analysis, and navigation improvements.
Generate a JTBD-oriented Table of Contents from JTBD records. Use after running jtbd-analyze or with existing JSONL files. Organizes content by user goals and workflow stages.
End-to-end JTBD workflow for AsciiDoc repos using master.adoc. Runs all 4 steps (analyze, TOC, comparison, consolidation) in one command. Supports batch processing of multiple documents.
End-to-end JTBD workflow for topic map-based repos. Runs all 4 steps (analyze, TOC, comparison, consolidation) in one command. Supports batch processing of multiple books.
A collection of Claude Code plugins, skills, and agent tools for Red Hat documentation workflows.
# Add the marketplace
/plugin marketplace add https://github.com/redhat-documentation/redhat-docs-agent-tools.git
# Install a plugin
/plugin install hello-world@redhat-docs-agent-tools
# Update all plugins
/plugin marketplace update redhat-docs-agent-tools
Run make update to generate the plugin catalog locally, or browse the live site.
The documentation site is built with Zensical and auto-deployed to GitHub Pages on every merge to main.
Live site: https://redhat-documentation.github.io/redhat-docs-agent-tools/
# Install zensical
python3 -m pip install zensical
# Start dev server
make serve
# Build site
make build
# Regenerate plugin docs
make update
.
├── .github/workflows/ # CI: docs build + deploy on merge to main
├── .claude-plugin/ # Plugin marketplace configuration
├── docs/ # Zensical site source (Markdown)
├── plugins/ # Plugin implementations
│ ├── docs-tools/ # Documentation review, writing, and workflow tools
│ ├── hello-world/ # Reference plugin
│ └── vale-tools/ # Vale linting tools
├── scripts/ # Doc generation scripts
├── zensical.toml # Zensical site config
├── Makefile # Build automation
├── CLAUDE.md # Claude Code project config
├── CONTRIBUTING.md # Contribution guidelines
└── LICENSE # Apache-2.0
Contributions are welcome from anyone using any editor or AI coding tool. See CONTRIBUTING.md for guidelines on creating plugins and submitting changes.
Apache-2.0. See LICENSE.
Documentation review, writing, and workflow tools for Red Hat AsciiDoc and Markdown documentation.
Share bugs, ideas, or general feedback.
Multi-LLM documentation review for catching inconsistencies, codebase mismatches, and gaps. Supports Opus, GPT, and Gemini in parallel with synthesis and guided resolution.
Technical documentation specialist for README files, API docs, user guides, specifications, and release notes with Obsidian vault management
Engineering & tech skills: Code Review Checklist, Incident Postmortem, API Docs Writer, Architecture Decision Record. Structured outputs for engineering teams and technical PMs.
Comprehensive AI-assisted requirements elicitation. Supports stakeholder interviews (LLMREI pattern), document extraction, stakeholder simulation, domain research, gap analysis, user story mapping, customer journey mapping, JTBD analysis, prioritization (MoSCoW/Kano/WSJF), surveys, workshops, brainstorming, and business rules analysis. Exports to canonical, EARS, and Gherkin formats.
Documentation review, cleanup, and generation with AI slop detection, style learning, and human-quality writing enforcement