wiki-structure

Analyze wiki topology to detect hub pages, orphans, dead-ends, and tag clusters.

Updated Aug 2, 2026
One-click install
npx skills add https://github.com/phm-aguiar/test_documentacao --skill wiki-structure-phm-aguiar
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: wiki-structure
Source: https://github.com/phm-aguiar/test_documentacao/tree/main/.claude/skills/wiki-structure
Command: npx skills add https://github.com/phm-aguiar/test_documentacao --skill wiki-structure-phm-aguiar

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Wikis grow organically and often develop structural problems: isolated pages nobody links to, dead-end pages with no outgoing links, unbalanced categories, and hidden information gaps. This Skill analyzes the connectivity and topology of an Obsidian-style wiki to surface these issues with concrete improvement recommendations. ## Core Features & Use Cases - Topology Detection: Identifies hub pages, bridge pages, dead-ends, and orphan pages based on incoming and outgoing link counts. - Tag Cluster & Gap Analysis: Groups related tags by prefix, finds orphaned tags used only once, and detects unresolved links pointing to missing pages. - Health Scoring: Produces a structure score with green/yellow/red thresholds for orphans, unresolved links, dead-ends, and category balance. - Use Case: Run a full structural analysis on a 267-page knowledge base to discover that journal entries are bloated, two tags are orphaned, and the references category needs rebalancing. ## Quick Start Ask the assistant to analyze the wiki structure and report hub pages, orphans, and improvement recommendations.

Frequently Asked Questions about wiki-structure

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I find orphan pages in an Obsidian wiki?▼

Run the structure or health analysis, which detects pages with zero incoming links. Orphans should either be linked from index or hub pages, archived if stale, or flagged as newly created content awaiting discovery.

How to detect hub pages in a markdown knowledge base?▼

Hub pages are detected by counting incoming backlinks (typically 5 or more) and outgoing links (typically 8 or more), plus their role bridging multiple clusters. The analysis lists these high-connectivity pages as critical information architecture nodes.

What is the difference between wiki-structure and wiki-lint?▼

wiki-structure analyzes topology and connectivity patterns like hubs, orphans, and tag clusters, while wiki-lint performs health audits on format and content issues. They are complementary and often run together.

Does this analysis require obsidian-cli?▼

Yes, the analysis is powered by obsidian-cli through the wiki-cli.py wrapper script for performance. Commands like structure, health, files, and tags are executed against a specified vault directory.

What thresholds indicate wiki structure problems?▼

Red-level issues include 3 or more orphans, 4 or more unresolved links, over 20 dead-ends, more than 15 percent orphaned tags, or a category balance ratio below 0.5. Green means zero orphans and unresolved links.