How do I install the Veles skill?

Run npx skillmds@latest add bestdeejay-design/veles in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Veles safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Veles?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Veles free to use?

Yes. Installing skills from SkillMD is free. This skill is licensed under MIT.

bestdeejay-design (@bestdeejay-design) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Veles by bestdeejay-design — Agent Skill

Name: Veles
Author: bestdeejay-design

Veles

Documentation statistician — finds orphan documents (no inbound references), computes documentation metrics, detects dead zones (folders unlinked from main docs), validates link hierarchy L1→L2→L3→L4. Use when: "find orphans", "orphan docs", "unreferenced documents", "documentation stats", "doc metrics", "dead zones", "link hierarchy", "veles".

bestdeejay-design 8e9c584 2 files · 3.5 KB Updated Sep 17, 2026

File contents

Veles — Statistician

Finds orphan documents, computes documentation metrics, detects dead zones, validates link hierarchy.

What it does

Orphans — documents with zero inbound references from other docs
Statistics — file count, word count, level distribution, link count
Dead zones — folders with no references from main documentation tree
Hierarchy validation — enforces L1→L2→L3→L4 reference direction

Link Hierarchy

L1 (Contracts) → L2 (Product Canon) → L3 (Engineering Canon) → L4 (Derived)

Upper levels reference lower levels. Veles flags violations (e.g., L3 referencing L1 directly).

Usage

# Via Chronos orchestrator
chronos --path . --preset full

# Direct invocation
python -m chronos.agents.veles --path .

Output Format

[nit] orphan: CONTRIBUTING.md — no inbound references from other documents
[info] stats: 12 documents, 4500 words, 3 levels, 28 links
[warning] hierarchy_violation: docs/ADR/001.md (L3) references contracts/openapi.yaml (L1) directly
[info] dead_zone: docs/legacy/ — no references from L1-L4

Metrics Computed

Metric	Description
`total_files`	Markdown files scanned
`total_words`	Aggregate word count
`level_distribution`	Count per L1-L6
`link_count`	Total internal links
`orphan_count`	Documents with 0 inbound links
`dead_zone_count`	Unreferenced folders

Triggers

find orphans / orphan docs / unreferenced documents
documentation stats / doc metrics / documentation statistics
dead zones / unlinked folders
link hierarchy / reference hierarchy
veles

Integration

Loaded by Chronos as part of full preset only.

---name: velesdescription: Documentation statistician — finds orphan documents (no inbound references), computes documentation metrics, detects dead zones (folders unlinked from main docs), validates link hierarchy L1→L2→L3→L4. Use when: "find orphans", "orphan docs", "unreferenced documents", "documentation stats", "doc metrics", "dead zones", "link hierarchy", "veles".license: MIT---# Veles — StatisticianFinds orphan documents, computes documentation metrics, detects dead zones, validates link hierarchy.## What it does- **Orphans** — documents with zero inbound references from other docs- **Statistics** — file count, word count, level distribution, link count- **Dead zones** — folders with no references from main documentation tree- **Hierarchy validation** — enforces L1→L2→L3→L4 reference direction## Link Hierarchy```L1 (Contracts) → L2 (Product Canon) → L3 (Engineering Canon) → L4 (Derived)```Upper levels reference lower levels. Veles flags violations (e.g., L3 referencing L1 directly).## Usage```bash# Via Chronos orchestratorchronos --path . --preset full# Direct invocationpython -m chronos.agents.veles --path .```## Output Format```[nit] orphan: CONTRIBUTING.md — no inbound references from other documents[info] stats: 12 documents, 4500 words, 3 levels, 28 links[warning] hierarchy_violation: docs/ADR/001.md (L3) references contracts/openapi.yaml (L1) directly[info] dead_zone: docs/legacy/ — no references from L1-L4```## Metrics Computed| Metric | Description ||--------|-------------|| `total_files` | Markdown files scanned || `total_words` | Aggregate word count || `level_distribution` | Count per L1-L6 || `link_count` | Total internal links || `orphan_count` | Documents with 0 inbound links || `dead_zone_count` | Unreferenced folders |## Triggers- `find orphans` / `orphan docs` / `unreferenced documents`- `documentation stats` / `doc metrics` / `documentation statistics`- `dead zones` / `unlinked folders`- `link hierarchy` / `reference hierarchy`- `veles`## IntegrationLoaded by Chronos as part of `full` preset only.

Frequently asked questions