# Dita Validate Asciidoc

> 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.

- **Type:** Skill
- **Install:** `agentstack add skill-abhatt-rh-redhat-docs-agent-tools-dita-validate-asciidoc`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [abhatt-rh](https://agentstack.voostack.com/s/abhatt-rh)
- **Installs:** 0
- **Category:** [Content & Media](https://agentstack.voostack.com/c/content-and-media)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [abhatt-rh](https://github.com/abhatt-rh)
- **Source:** https://github.com/abhatt-rh/redhat-docs-agent-tools/tree/main/plugins/dita-tools/skills/dita-validate-asciidoc
- **Website:** https://redhat-documentation.github.io/redhat-docs-agent-tools/

## Install

```sh
agentstack add skill-abhatt-rh-redhat-docs-agent-tools-dita-validate-asciidoc
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Validate AsciiDoc for DITA Conversion

Validate AsciiDoc assemblies or modules for DITA conversion readiness by running Vale linting with AsciiDocDITA rules. Results are formatted as a markdown table with one issue per row.

## Overview

This skill runs Vale with the AsciiDocDITA rule set to identify DITA compatibility issues in AsciiDoc files. For assemblies, it automatically discovers all included files using `dita-includes`. Only warnings and errors are reported (suggestions are excluded).

## Usage

```bash
bash ${CLAUDE_SKILL_DIR}/scripts/validate_asciidoc.sh  [options]
```

### Options

| Option | Description |
|--------|-------------|
| `-l, --list-only` | Only list files, don't run Vale |
| `-h, --help` | Show help message |

### Examples

```bash
# Validate an assembly and all includes (only existing files are processed)
bash ${CLAUDE_SKILL_DIR}/scripts/validate_asciidoc.sh master.adoc

# List files that would be validated
bash ${CLAUDE_SKILL_DIR}/scripts/validate_asciidoc.sh master.adoc --list-only
```

## Output format

The script outputs Vale issues in line format:

```
file:line:column:severity:rule:message
```

Example output:

```
/path/to/modules/con-intro.adoc:12:5:warning:AsciiDocDITA.BlockTitle:Block titles are not supported
/path/to/modules/proc-install.adoc:8:1:error:AsciiDocDITA.HardLineBreak:Hard line breaks are not supported
/path/to/modules/ref-options.adoc:25:10:warning:AsciiDocDITA.EntityReference:Use Unicode instead of HTML entities
```

## Formatting as markdown table

After running the script, format the output as a markdown table:

| File | Line | Severity | Rule | Message |
|------|------|----------|------|---------|
| modules/con-intro.adoc | 12 | warning | AsciiDocDITA.BlockTitle | Block titles are not supported |
| modules/proc-install.adoc | 8 | error | AsciiDocDITA.HardLineBreak | Hard line breaks are not supported |
| modules/ref-options.adoc | 25 | warning | AsciiDocDITA.EntityReference | Use Unicode instead of HTML entities |

Include a summary at the end:

**Summary:** 1 error, 2 warnings

## How it works

1. Discovers all included files using the `dita-includes` script
2. Creates a temporary Vale config with AsciiDocDITA rules only
3. Runs `vale sync` to download the AsciiDocDITA package
4. Runs Vale with `--minAlertLevel=warning` on all files
5. Outputs issues in parseable line format

## Vale configuration

The script uses a hardcoded Vale configuration:

```ini
StylesPath = .vale/styles

MinAlertLevel = warning

Packages = https://github.com/jhradilek/asciidoctor-dita-vale/releases/latest/download/AsciiDocDITA.zip

[*.adoc]
BasedOnStyles = AsciiDocDITA
```

## Prerequisites

- Vale must be installed: https://vale.sh/docs/vale-cli/installation/
- The `dita-tools:dita-includes` skill script must be available

## Example invocations

- "Validate the master.adoc for DITA conversion"
- "Check the assembly for DITA issues"
- "Run DITA validation on modules/con-overview.adoc"
- "What issues will I have converting this to DITA?"
- "Are there any AsciiDocDITA errors in the assembly?"

## Script location

```
scripts/
└── validate_asciidoc.sh    # Bash script for DITA validation
```

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [abhatt-rh](https://github.com/abhatt-rh)
- **Source:** [abhatt-rh/redhat-docs-agent-tools](https://github.com/abhatt-rh/redhat-docs-agent-tools)
- **License:** Apache-2.0
- **Homepage:** https://redhat-documentation.github.io/redhat-docs-agent-tools/

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-abhatt-rh-redhat-docs-agent-tools-dita-validate-asciidoc
- Seller: https://agentstack.voostack.com/s/abhatt-rh
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.