From dita-tools
Recursively lists all AsciiDoc files referenced via include:: directives, with cycle detection, deduplication, sorting, and absolute paths. Use for analyzing document structure, dependencies, or DITA conversion prep.
npx claudepluginhub redhat-documentation/redhat-docs-agent-tools --plugin dita-toolsThis skill is limited to using the following tools:
Recursively find all AsciiDoc files referenced via `include::` directives in a document, traversing all child includes to build a complete dependency list.
Flattens AsciiDoc assemblies by expanding all include directives into a single self-contained document using asciidoctor-reducer. Useful for reducing, resolving, or normalizing nested documentation.
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.
Extracts Jobs-To-Be-Done records from modular AsciiDoc documentation repos. Analyzes assemblies, includes, conditionals via reduction, source mapping, and chunked analysis for user goals.
Share bugs, ideas, or general feedback.
Recursively find all AsciiDoc files referenced via include:: directives in a document, traversing all child includes to build a complete dependency list.
This skill parses AsciiDoc files for include:: directives and follows them recursively to produce a complete, sorted, and deduplicated list of all referenced files. This is useful for:
= Master Guide
include::_attributes/common.adoc[]
include::modules/con-intro.adoc[leveloffset=+1]
include::assemblies/getting-started.adoc[leveloffset=+1]
Where assemblies/getting-started.adoc contains:
= Getting Started
include::../modules/proc-install.adoc[leveloffset=+1]
include::../modules/proc-configure.adoc[leveloffset=+1]
/home/user/docs/_attributes/common.adoc
/home/user/docs/assemblies/getting-started.adoc
/home/user/docs/master.adoc
/home/user/docs/modules/con-intro.adoc
/home/user/docs/modules/proc-configure.adoc
/home/user/docs/modules/proc-install.adoc
bash scripts/find_includes.sh <file.adoc> [options]
| Option | Description |
|---|---|
-a, --absolute | Output absolute paths (default) |
-r, --relative | Output paths relative to input file directory |
-e, --existing | Only output files that exist |
-h, --help | Show help message |
# List all includes from an assembly (absolute paths by default)
bash scripts/find_includes.sh master.adoc
# Get relative paths instead
bash scripts/find_includes.sh docs/guide.adoc --relative
# Only list files that exist (skip broken includes)
bash scripts/find_includes.sh master.adoc --existing
# Combine options
bash scripts/find_includes.sh master.adoc -e
{attribute} placeholders are skipped with a warning, as they cannot be resolved without knowing attribute valuesifdef/ifndef preprocessor directives; all includes are listed regardless of conditionsscripts/
└── find_includes.sh # Bash script for recursive include discovery