jtbd-analyze-adoc

Extract JTBD records from Red Hat modular AsciiDoc documentation.

Updated Aug 27, 2026

Search Tags:#documentation #analysis #jtbd #asciidoc #user goals #modular docs

Ready to run

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

💬 Prompt for ChatGPT / Claude Chat▼

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires asciidoctor-reducer, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the extraction of Jobs-To-Be-Done (JTBD) records from complex AsciiDoc documentation, enabling more user-centric restructuring and analysis of Red Hat's modular documentation.

Core Features & Use Cases

JTBD Extraction: Identifies user goals and JTBDs within AsciiDoc content.
Source Mapping: Preserves traceability from extracted records back to original source files and lines.
Modular Doc Handling: Specifically designed for Red Hat's modular AsciiDoc structure (assemblies, includes, conditionals).
Use Case: Analyze the "Deploying Models" assembly in the OpenShift AI documentation to identify key user tasks and goals, informing future content organization.

Quick Start

Analyze the AsciiDoc file located at ~/Documents/RHAI_DOCUMENTATION/openshift-ai-documentation/deploying-models/master.adoc for self-managed variants.

Frequently Asked Questions about jtbd-analyze-adoc

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

FAQPage Schema

How do I extract Jobs-To-Be-Done records from AsciiDoc documentation?▼

You can extract user goals and JTBDs from complex Red Hat modular AsciiDoc files. The Skill flattens assemblies, resolves includes and conditionals, maps extracted sections to original source files, and performs grounding validation for accurate analysis.

Can I analyze large AsciiDoc assemblies that use includes and conditionals?▼

Yes, you can analyze large modular AsciiDoc assemblies. The Skill resolves includes and conditionals, flattens assemblies, and handles large documents via chunked subagent processing to map extracted sections back to original source files.

Does this JTBD analysis tool require asciidoctor-reducer to process modular docs?▼

Yes, this JTBD analysis tool requires the asciidoctor-reducer dependency to process modular docs. It relies on this component to flatten assemblies and resolve includes before extracting user goals from the AsciiDoc content.

What is the best way to trace extracted JTBD records back to original AsciiDoc source files?▼

The best way to trace extracted JTBD records back to original AsciiDoc source files is through source mapping. The Skill preserves traceability by mapping extracted sections to original modules and source lines during the analysis process.

How do I analyze Red Hat modular documentation for user-centric content restructuring?▼

To analyze Red Hat modular documentation for user-centric restructuring, point this Skill at your master.adoc assembly file. It extracts Jobs-To-Be-Done records to identify key user tasks and goals, informing future content organization.