Skip to content
Back to skills

Cqa 14 No Broken Links

ASecurity

Detects broken include and image targets that reference non-existent files. Use when restructuring content or after file renames.

  • 25 stars
  • 0 votes
  • 0 copies
  • 3 views
  • Added May 28, 2026
documentationbashnode

Security analysis

A100/100

Scanned May 28, 2026

npx -y skills add redhat-developer/red-hat-developers-documentation-rhdh --skill cqa-14-no-broken-links --agent claude-code

Installs into .claude/skills of the current project.

Are you the author of Cqa 14 No Broken Links?

Add the live security badge to your README. It updates with every re-scan.

Security grade badge for Cqa 14 No Broken Links
[![Security: A — Skills Directory](https://www.skillsdirectory.com/api/skills/redhat-developer-cqa-14-no-broken-links/badge)](https://www.skillsdirectory.com/skills/redhat-developer-cqa-14-no-broken-links)

More formats (shields.io, HTML) on the badges page. Keep it an A: scan every change in CI with Pro.

Download with Pro
SKILL.md
---
name: cqa-14-no-broken-links
description: Detects broken include and image targets that reference non-existent files. Use when restructuring content or after file renames.
---

# CQA-14: Broken Links

**Spec:** See `resources/cqa-spec.md` section "CQA-14: ..." for full detection/fix logic and edge cases.

## Run

```bash
# Report
node build/scripts/cqa/index.js --check 14 titles/<your-title>/master.adoc

# Fix
node build/scripts/cqa/index.js --check 14 --fix titles/<your-title>/master.adoc
```

## What It Checks
- `include::` directive targets must point to existing files
- `image::` directive targets must point to existing image files
- Skips paths containing AsciiDoc attribute substitutions (e.g., `{attr-name}`)

## Manual Items
All issues are MANUAL. Broken links need human judgment to determine the correct target file or whether the reference should be removed.

Attribution

Is this your skill, or is something wrong with this listing? Request removal or report an issue. Author removals are honored within 72 hours.

Comments

Loading comments…