jtbd-workflow-topicmap

Parse YAML topic maps and generate JTBD consolidation reports.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/redhat-documentation/redhat-docs-agent-tools --skill jtbd-workflow-topicmap
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: jtbd-workflow-topicmap
Source: https://github.com/redhat-documentation/redhat-docs-agent-tools/tree/main/plugins/jtbd-tools/skills/jtbd-workflow-topicmap
Command: npx skills add https://github.com/redhat-documentation/redhat-docs-agent-tools --skill jtbd-workflow-topicmap

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill automates the entire process of analyzing documentation using the Jobs-to-be-Done (JTBD) framework, transforming raw topic maps into structured reports, comparisons, and consolidated documentation.

Core Features & Use Cases

  • Comprehensive Analysis: Parses topic maps, reduces assemblies, extracts JTBD records, and generates include graphs.
  • Structured Outputs: Creates JTBD-oriented Tables of Contents, comparison reports, and stakeholder consolidation reports.
  • Batch Processing: Supports processing multiple books or repositories in a single run.
  • Use Case: Analyze an entire OpenShift documentation book, generate a new JTBD-based TOC, compare it with the current structure, and produce a consolidation report for stakeholders, all with a single command.

Quick Start

Run the jtbd-workflow-topicmap skill on the provided repository path for the 'installing_gitops' book.

Frequently Asked Questions about jtbd-workflow-topicmap

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

FAQPage Schema
How do I automate Jobs-to-be-Done analysis for documentation organized by topic maps?

You can automate Jobs-to-be-Done analysis by parsing YAML topic maps, reducing AsciiDoc assemblies, extracting JTBD records, and generating structured consolidation reports through a single orchestrated workflow.

What is a JTBD workflow for topic map repositories?

A JTBD workflow for topic map repositories is an end-to-end process that transforms raw documentation structures into JTBD-oriented Tables of Contents, comparison reports, and stakeholder consolidation reports.

How do I compare current documentation structures with proposed JTBD-based TOCs?

You compare current and proposed documentation structures by running the workflow to generate new JTBD-oriented TOCs and automatically producing comparison reports that highlight structural differences.

Do I need Ruby and asciidoctor-reducer to process AsciiDoc assemblies for JTBD analysis?

Yes, Ruby and the asciidoctor-reducer dependency are required to reduce AsciiDoc assemblies during the JTBD analysis workflow before extracting records and generating reports.

Can I run batch processing for JTBD documentation analysis across multiple books?

Yes, batch processing supports analyzing multiple documentation books or repositories in a single run, extracting JTBD records and generating consolidated reports for each.

How do I apply research configuration overlays for domain-specific JTBD analysis?

Research configuration overlays allow you to customize domain-specific JTBD analysis parameters, tailoring the extraction of records and generation of TOCs to specific documentation contexts.