jtbd-workflow-adoc

Orchestrate multi-step JTBD analysis workflows for AsciiDoc documentation.

Updated Aug 27, 2026

Search Tags:#workflow #documentation #analysis #reporting #jtbd #asciidoc

One-click install

npx skills add https://github.com/redhat-documentation/redhat-docs-agent-tools --skill jtbd-workflow-adoc

Or copy as Structured Prompt for Agent▼

Please help me install this Agent Skill.
Skill: jtbd-workflow-adoc
Source: https://github.com/redhat-documentation/redhat-docs-agent-tools/tree/main/plugins/jtbd-tools/skills/jtbd-workflow-adoc
Command: npx skills add https://github.com/redhat-documentation/redhat-docs-agent-tools --skill jtbd-workflow-adoc

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill automates the entire process of analyzing AsciiDoc documentation for Just-By-The-Job (JTBD) insights, transforming raw content into structured reports and actionable insights.

Core Features & Use Cases

Comprehensive Analysis: Runs all four JTBD workflow steps: analyze, TOC generation, comparison, and consolidation.
AsciiDoc Support: Specifically designed for AsciiDoc repositories using master.adoc as an entry point.
Batch Processing: Efficiently handles multiple documents in a single run.
Use Case: Analyze a large set of Red Hat documentation books to identify user needs, improve navigation, and generate stakeholder reports, all with a single command.

Quick Start

Run the jtbd-workflow-adoc skill on the file path/to/master.adoc with the self-managed variant.

Frequently Asked Questions about jtbd-workflow-adoc

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

FAQPage Schema

How do I automate JTBD analysis for AsciiDoc documentation?▼

JTBD analysis for AsciiDoc is automated by orchestrating a multi-step workflow that extracts user needs, generates source maps, creates TOCs, and consolidates structural comparison reports using master.adoc as the entry point.

What is the best way to extract JTBD insights from multiple AsciiDoc files at once?▼

The best way to extract JTBD insights from multiple AsciiDoc files is using batch processing. This workflow handles multiple documents in a single run and resolves conditional content variants to efficiently generate structured reports.

Does this JTBD workflow support conditional content and variant resolution in AsciiDoc?▼

Yes, this JTBD workflow supports variant resolution for conditional content in AsciiDoc. It processes master.adoc files and resolves conditional variants during content reduction and source map generation to ensure accurate analysis.

How do I generate structural comparison and consolidation reports for AsciiDoc repositories?▼

You generate structural comparison and consolidation reports by running the final steps of the JTBD workflow. After content reduction and extraction, the workflow automatically creates TOCs, compares structures, and outputs a consolidated stakeholder report.

Can I analyze Red Hat documentation books to identify user needs and improve navigation?▼

Yes, you can analyze Red Hat documentation books to identify user needs and improve navigation. The workflow runs comprehensive JTBD extraction and TOC generation on large sets of AsciiDoc repositories to produce actionable stakeholder reports.