Skip to content
Back to skills

Cqa 07 Toc Depth

ASecurity

Validates maximum heading depth does not exceed 3 levels. Use when deep heading nesting is detected.

  • 25 stars
  • 0 votes
  • 0 copies
  • 1 view
  • Added May 28, 2026
researchbashnode

Security analysis

A100/100

Scanned May 28, 2026

npx -y skills add redhat-developer/red-hat-developers-documentation-rhdh --skill cqa-07-toc-depth --agent claude-code

Installs into .claude/skills of the current project.

Are you the author of Cqa 07 Toc Depth?

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

Security grade badge for Cqa 07 Toc Depth
[![Security: A — Skills Directory](https://www.skillsdirectory.com/api/skills/redhat-developer-cqa-07-toc-depth/badge)](https://www.skillsdirectory.com/skills/redhat-developer-cqa-07-toc-depth)

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-07-toc-depth
description: Validates maximum heading depth does not exceed 3 levels. Use when deep heading nesting is detected.
---

# CQA-07: TOC Depth

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

## Run

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

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

## What It Checks
- Maximum 3 heading levels allowed (`=`, `==`, `===`)
- Detects `====` (level 4) and deeper headings that exceed the limit
- Validates table of contents depth is navigable

## Manual Items
Many deep headings (more than 3 violations) require human judgment to restructure content. Auto-fix promotes `====` to `===` only when there are 3 or fewer violations.

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…

Newsletter

Get the weekly list of safe new skills, and the ones we pulled.