cqa-tools

v1.0.2

CQA 2.1 Content Quality Assessment toolkit for Red Hat modular documentation. Assess, fix, and score 54 parameters across Pre-migration, Quality, and Onboarding tabs.

Assess, fix, and score Red Hat modular documentation against all 54 CQA 2.1 parameters.

Tip

Always run Claude Code from a terminal in the root of the documentation repository you are working on. The CQA tools command and skills operate on the current working directory, reading local .adoc files and writing output relative to the repo root.

Prerequisites

Install the Red Hat Docs Agent Tools marketplace
Install software dependencies
Install dita-tools plugin

Usage

# Full assessment
/cqa-tools:cqa-assess /path/to/docs-repo

# Assess and fix
/cqa-tools:cqa-assess /path/to/docs-repo --mode fix

# Assess one assembly and its topics
/cqa-tools:cqa-assess /path/to/docs-repo --scope assembly

References

reference/scoring-guide.md — Scoring rules and parameter-to-skill mapping
reference/checklist.md — Full 54-parameter CQA 2.1 checklist
Red Hat modular docs guide
DITA 1.3 spec

Install

/plugin install cqa-tools@redhat-docs-agent-tools

Update

/plugin marketplace update redhat-docs-agent-tools

Commands

`cqa-assess`

/cqa-tools:cqa-assess <docs-repo-path> [--scope repo|assembly|topic] [--mode assess|fix]

Run a CQA 2.1 content quality assessment against a Red Hat modular documentation repository

Skills

Skill	Description
`cqa-assess`	Use when starting or continuing a full CQA 2.1 content quality assessment. Guides through all three tabs (Pre-migration, Quality, Onboarding) parameter by parameter.
`cqa-editorial`	Use when assessing CQA parameters P13-P14, Q1-Q5, Q18, Q20 (editorial quality). Checks grammar, content types, readability, scannability, fluff, style guide compliance, and tone.
`cqa-legal-branding`	Use when assessing CQA parameters P18-P19, Q17, Q23, O1-O5 (legal, branding, and compliance). Checks product names, Tech Preview disclaimers, conscious language, non-RH link disclaimers, and copyright.
`cqa-links`	Use when assessing CQA parameters P15-P17, Q24-Q25 (links and URLs). Checks for broken xrefs, missing includes, missing images, redirect integrity, and content interlinking.
`cqa-modularization`	Use when assessing CQA parameters P2-P7 (modularization). Checks assembly structure, module prefixes, required elements, templates, and nesting depth.
`cqa-onboarding`	Use when assessing CQA parameters O6-O10 (onboarding to docs.redhat.com). Checks support disclaimers, SME verification, source format, Pantheon publishing, and official site publication.
`cqa-procedures`	Use when assessing CQA parameters P12, Q12-Q16 (procedure quality). Checks prerequisites, step counts, command examples, optional/conditional step formatting, verification sections, and Additional resources.
`cqa-report`	Use when all CQA parameters have been assessed and you need to generate the final CQA 2.1 assessment report with scores, evidence, and summary tables.
`cqa-tables-images`	Use when assessing CQA parameters Q19, Q21-Q22 (tables and images). Checks for excessive screenshots, table captions, and image alt text.
`cqa-titles-descriptions`	Use when assessing CQA parameters P8-P11 (titles and short descriptions). Checks abstract quality, character limits, and title conventions.
`cqa-user-focus`	Use when assessing CQA parameters Q6-Q11 (user focus). Checks persona targeting, pain point coverage, acronym expansion, Additional resources quality, admonition density, and assembly introduction audience targeting.
`cqa-vale-check`	Use when assessing CQA parameter P1 (Vale DITA check). Runs Vale with AsciiDocDITA rules (direct for repo scope, dita-tools:dita-validate-asciidoc for assembly/topic scope) and fixes violations to achieve 0 errors and 0 warnings.