---
name: hashgraph-online-validate
description: "Run the profile-aware DocFlow documentation readiness gate. Always blocks broken links, stale maps, and missing headings; applies native naming and section rules strictly to new scaffolds while treating established adopted structures as cleanup guidance."
license: "Apache-2.0"
metadata:
  decimalai-skill-id: "8ce771c5-df1b-455b-a128-7b76f947f557"
  decimalai-version-id: "7fedb85b-b3a0-44a7-8dc2-fb23c6376ac7"
  decimalai-version: "3"
  decimalai-body-sha256: "1d9f1b9abfa7cf173574f996bb9b301d51c0583060b1b395e9938d594dae0330"
  decimalai-name: "hashgraph-online/validate"
  decimalai-format: "1"
  decimalai-invocation: "model"
  decimalai-category: "documentation"
  decimalai-source: "https://app.decimal.ai/s/hashgraph-online-validate@3/SKILL.md"
---
# validate

Goal: block objectively broken documentation before an agent reports work as complete.

## Run

```bash
bash scripts/docflow-validate.sh --target <REPO ROOT>
```

If running from an installed plugin where scripts are not in the target repo, use the plugin script path.

## Interpret

- `Errors` are blockers. Fix them before saying the docs are complete.
- `Warnings` are legacy/adoption cleanup. Report them, but they do not block unless the user asked for a strict cleanup.
- Fresh scaffold placeholders are warnings because new repos intentionally start from templates.
- `strict` is the native scaffold profile; `adopted` preserves established naming and section vocabulary.

## Rules

- Run after `/docflow:author`, `/docflow:changelog`, `/docflow:repair`, or any manual docs edit.
- Regenerate `INDEX.md` before validation when files were added, renamed, or removed.
- Keep the output concise: status, blockers, warnings worth acting on.