From dita-tools
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.
npx claudepluginhub redhat-documentation/redhat-docs-agent-tools --plugin dita-toolsThis skill is limited to using the following tools:
Fix list continuations in procedure steps for DITA compatibility.
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.
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.
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.
Share bugs, ideas, or general feedback.
Fix list continuations in procedure steps for DITA compatibility.
This skill uses the task_step.rb Ruby script to find procedure steps that contain multi-block content without proper list continuation markers (+) and adds them.
The Vale rule TaskStep.yml detects content in procedure modules that appears after steps but is not properly attached to a step using the list continuation marker (+).
In AsciiDoc, a list continuation marker (+ on its own line) attaches a block to the preceding list item. Without it, the block is not part of the list item.
See: https://docs.asciidoctor.org/asciidoc/latest/lists/continuation/
Before:
.Procedure
. Run the following command:
[source,bash]
----
oc get pods
----
. Check the output.
After:
.Procedure
. Run the following command:
+
[source,bash]
----
oc get pods
----
. Check the output.
Before:
.Procedure
. Configure the settings.
The configuration file is located at `/etc/myapp/config.yaml`.
. Restart the service.
After:
.Procedure
. Configure the settings.
+
The configuration file is located at `/etc/myapp/config.yaml`.
. Restart the service.
Before:
.Procedure
. Run the installer.
[NOTE]
====
The installation may take several minutes.
====
. Verify the installation.
After:
.Procedure
. Run the installer.
+
[NOTE]
====
The installation may take several minutes.
====
. Verify the installation.
When the user asks to fix list continuations:
:_mod-docs-content-type: PROCEDURE)ruby scripts/task_step.rb <file>
To preview changes without modifying files:
ruby scripts/task_step.rb <file> --dry-run
ruby scripts/task_step.rb <file> -o <output.adoc>
find <folder> -name "*.adoc" -exec ruby scripts/task_step.rb {} \;
:_mod-docs-content-type: PROCEDURE are skipped.Procedure section is processed+ markers are not duplicated<file>: Added N list continuation(s)
Or:
<file>: No missing list continuations found
Or:
<file>: Not a procedure module (skipped)
The Ruby script is located at: scripts/task_step.rb
This skill addresses the warning from: .vale/styles/AsciiDocDITA/TaskStep.yml