Skill

dita-task-contents

Adds missing .Procedure block titles before first ordered lists in AsciiDoc procedure modules (:_mod-docs-content-type: PROCEDURE) for DITA task mapping. Use to fix procedure markers or prep for DITA conversion.

Ruby

Bash

documentation

npx claudepluginhub redhat-documentation/redhat-docs-agent-tools --plugin dita-tools

Configuration

Model: claude-haiku-4-5@20251001

Tool Access

This skill is limited to using the following tools:

BashGlobReadEditWrite

Preview

Add missing `.Procedure` block title to procedure modules for DITA compatibility.

Supporting Assets

scripts/task_contents.rb

SKILL.md

Similar Skills

dita-task-step

Fixes missing list continuation markers (+) in AsciiDoc procedure steps for DITA compatibility using Ruby script task_step.rb. Useful when fixing task steps or preparing procedures for DITA.

1 file5 tools

dita-tools

docs-review-modular-docs

Reviews AsciiDoc (.adoc) files for Red Hat modular documentation compliance: module types (concept, procedure, reference), assembly structure, anchor IDs with _{context}, context variables, and include directives.

docs-tools

cqa-procedures

Assesses CQA parameters P12, Q12-Q16 for procedure quality in Red Hat modular docs: prerequisites label/formatting/count/language, step limits, command examples, optional steps, verification, resources.

6 tools

cqa-tools

Stats

Parent Repo Stars14

Parent Repo Forks11

Last CommitMar 13, 2026

Actions

View Source View Plugin View on GitHub View README

Help us improve

Share bugs, ideas, or general feedback.

Task contents (Procedure title) skill

Add missing .Procedure block title to procedure modules for DITA compatibility.

Overview

This skill uses the task_contents.rb Ruby script to find procedure modules that are missing the .Procedure block title and adds it before the first ordered list (the procedure steps).

What it detects

The Vale rule TaskContents.yml detects procedure modules (files with :_mod-docs-content-type: PROCEDURE) that do not have a .Procedure or ..Procedure block title.

What it adds

Missing .Procedure title

Before:

:_mod-docs-content-type: PROCEDURE
[id="installing-software"]
= Installing the software

[role="_abstract"]
Install the software using the package manager.

.Prerequisites

* You have admin access.
* The repository is configured.

. Download the package.
. Run the installer.
. Verify the installation.

After:

:_mod-docs-content-type: PROCEDURE
[id="installing-software"]
= Installing the software

[role="_abstract"]
Install the software using the package manager.

.Prerequisites

* You have admin access.
* The repository is configured.

.Procedure

. Download the package.
. Run the installer.
. Verify the installation.

Why this matters

The .Procedure block title is required to properly map procedure steps to DITA task elements. Without it, the converter cannot identify where the task steps begin.

Usage

When the user asks to fix procedure titles:

Identify the target folder or file containing AsciiDoc content
Find procedure modules (files with :_mod-docs-content-type: PROCEDURE)
Run the Ruby script against each file:
```
ruby scripts/task_contents.rb <file>
```
Report the changes made

Dry run mode

To preview changes without modifying files:

ruby scripts/task_contents.rb <file> --dry-run

Output to different file

ruby scripts/task_contents.rb <file> -o <output.adoc>

Process all files in a directory

find <folder> -name "*.adoc" -exec ruby scripts/task_contents.rb {} \;

Example invocations

"Add .Procedure titles to procedures in modules/"
"Fix missing procedure markers in the getting_started folder"
"Add .Procedure block title to all procedure files"
"Preview procedure title changes in modules/ --dry-run"

Behavior notes

Only processes procedures: Files without :_mod-docs-content-type: PROCEDURE are skipped
Skips existing titles: Files that already have .Procedure are not modified
Finds first ordered list: The .Procedure title is inserted before the first ordered list after any Prerequisites section
Handles Prerequisites: If a Prerequisites section exists, the script inserts after it
Skips code blocks: Ordered lists inside code blocks are not considered

Output format

<file>: Added .Procedure title before line N

Or:

<file>: .Procedure title already exists

Or:

<file>: Not a procedure module (skipped)

Or:

<file>: No ordered list found for procedure steps

Extension location

The Ruby script is located at: scripts/task_contents.rb

Related Vale rule

This skill addresses the warning from: .vale/styles/AsciiDocDITA/TaskContents.yml