Prepare AsciiDoc files for DITA conversion by automating cleanup, syntax validation, content rewriting, attribute addition, include resolution, and refactoring to Red Hat modular documentation standards. Run checks, fix issues like block titles, callouts, entities, and short descriptions, then generate git branches with summaries.
npx claudepluginhub redhat-documentation/redhat-docs-agent-tools --plugin dita-toolsAdd missing [role="_abstract"] attribute to AsciiDoc files for DITA short description support. Use this skill when asked to add abstract role attributes, mark short descriptions, or prepare files for DITA conversion.
Refactor AsciiDoc files for DITA conversion compatibility using LLM-guided analysis. Use this skill to fix Vale issues, prepare files for DITA conversion, or comprehensively rewrite AsciiDoc modules and assemblies following Red Hat modular documentation standards.
Fix unsupported block titles for DITA compatibility. Block titles are only valid for examples, figures (images), and tables. Use this skill when asked to fix block titles, remediate BlockTitle warnings, or prepare files for DITA conversion.
Transform callouts in AsciiDoc source blocks to prepare for DITA conversion. Use this skill when asked to transform, convert, or fix callouts in AsciiDoc files or folders.
Run asciidoctor to check AsciiDoc files for syntax errors. Outputs timestamped build log to /tmp. Reports warnings and errors, then reviews source to suggest fixes for common issues like unclosed conditionals, admonitions, and code blocks.
Add or update :_mod-docs-content-type: attribute in AsciiDoc files. Detects content type (CONCEPT, PROCEDURE, ASSEMBLY, SNIPPET) from file structure and adds the attribute if missing. Use this skill when asked to add content types, fix module types, or prepare files for DITA conversion.
Generate and insert missing document IDs for AsciiDoc titles. Use this skill when asked to add IDs, fix missing anchors, or prepare files for DITA conversion.
Replace HTML character entity references with Unicode equivalents for DITA compatibility. Use this skill when asked to fix entity references, replace HTML entities, or prepare files for DITA conversion.
List all AsciiDoc files referenced via include directives, recursively traversing child includes. Use this skill when asked to find includes, list dependencies, or analyze AsciiDoc file structure.
Remove hard line breaks from AsciiDoc files for DITA compatibility. Use this skill when asked to fix line breaks, remove forced breaks, or prepare files for DITA conversion.
Reduce AsciiDoc files by expanding all include directives into a single flattened document using asciidoctor-reducer. Use this skill when asked to reduce, flatten, resolve, or normalize AsciiDoc assemblies.
Fix Additional resources sections by removing or relocating non-link content for DITA compatibility. Use this skill when asked to fix additional resources, clean up related links, or prepare files for DITA conversion.
Extract inline content from AsciiDoc assembly files into separate modules. Use when refactoring assemblies to follow Red Hat modular documentation standards — moving introductory preambles, inline procedures, inline concepts, admonitions, or any other content into reusable modules.
Rewrite or improve short descriptions in AsciiDoc files for better clarity and DITA compliance. Use this skill when asked to fix short descriptions, improve abstracts, rewrite summaries, or make short descriptions more effective.
Add missing .Procedure block title to procedure modules for DITA compatibility. Use this skill when asked to fix procedure titles, add .Procedure markers, or prepare procedure files for DITA conversion.
Fix list continuations in procedure steps for DITA compatibility. Use this skill when asked to fix task steps, add list continuations, or prepare procedure files for DITA conversion.
Remove unsupported block titles from procedure modules for DITA compatibility. Use this skill when asked to fix task titles, remove unsupported titles, or prepare procedure files for DITA conversion.
Validate AsciiDoc files for DITA conversion readiness by running Vale linting with AsciiDocDITA rules. Reports warnings and errors in a markdown table format. Use this skill when asked to validate, check, or assess AsciiDoc files before DITA conversion.
A collection of Claude Code plugins, skills, and agent tools for Red Hat documentation workflows.
# Add the marketplace
/plugin marketplace add https://github.com/redhat-documentation/redhat-docs-agent-tools.git
# Install a plugin
/plugin install hello-world@redhat-docs-agent-tools
# Update all plugins
/plugin marketplace update redhat-docs-agent-tools
Run make update to generate the plugin catalog locally, or browse the live site.
The documentation site is built with Zensical and auto-deployed to GitHub Pages on every merge to main.
Live site: https://redhat-documentation.github.io/redhat-docs-agent-tools/
# Install zensical
python3 -m pip install zensical
# Start dev server
make serve
# Build site
make build
# Regenerate plugin docs
make update
.
├── .github/workflows/ # CI: docs build + deploy on merge to main
├── .claude-plugin/ # Plugin marketplace configuration
├── docs/ # Zensical site source (Markdown)
├── plugins/ # Plugin implementations
│ ├── docs-tools/ # Documentation review, writing, and workflow tools
│ ├── hello-world/ # Reference plugin
│ └── vale-tools/ # Vale linting tools
├── scripts/ # Doc generation scripts
├── zensical.toml # Zensical site config
├── Makefile # Build automation
├── CLAUDE.md # Claude Code project config
├── CONTRIBUTING.md # Contribution guidelines
└── LICENSE # Apache-2.0
Contributions are welcome from anyone using any editor or AI coding tool. See CONTRIBUTING.md for guidelines on creating plugins and submitting changes.
Apache-2.0. See LICENSE.
Documentation review, writing, and workflow tools for Red Hat AsciiDoc and Markdown documentation.
Share bugs, ideas, or general feedback.
Comprehensive documentation: ASCII diagrams, markdown standards, LaTeX build, Pandoc PDF generation
Documentation review, cleanup, and generation with AI slop detection, style learning, and human-quality writing enforcement
Agents specialized in technical documentation and knowledge management. Focuses on documentation architecture and user-focused writing.
Produce and review technical documentation that is clear, actionable, and maintainable for both humans and agents, including contributor-governance files and agent instruction files.
Documentation and authoring workflow router: audit docs vs code drift, sync docs after changes, optimize prompts and SKILL.md files, validate GLFM and Markdown formatting, summarize files/URLs/images with fidelity enforcement. Use when: docs are out of date, CLAUDE.md needs improving, SKILL.md needs optimizing, checking if documentation matches code, summarizing files or URLs.