hyalo-tidy

Detect structural issues and fix broken links in a Hyalo knowledgebase.

3|Updated Mar 14, 2026

Search Tags:#link-check #tidy #health-report #knowledgebase #orphan-files #metadata-normalization

Ready to run

npx skills add https://github.com/pjastam/ResearchVault --skill hyalo-tidy

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: hyalo-tidy
Source: https://github.com/pjastam/ResearchVault/tree/main/.claude/skills/hyalo-tidy
Command: npx skills add https://github.com/pjastam/ResearchVault --skill hyalo-tidy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Perform a reflective tidy over a hyalo-managed knowledgebase directory — detecting structural issues, fixing broken links, flagging stale content, normalizing metadata, and reporting what changed. Use this skill to ensure your KB remains coherent, consistent, and easy to navigate across teams.

Core Features & Use Cases

Detect broken links across the knowledgebase to ensure consistent navigation.
Normalize metadata and identify orphan files or stale iterations for clean curation.
Generate a health summary with actionable recommendations to improve KB hygiene.

Quick Start

Run the tidy pass on your Hyalo knowledgebase to audit structure, repair links, flag stale items, normalize metadata, and report changes.

Frequently Asked Questions about hyalo-tidy

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

FAQPage Schema

How do I detect broken links and orphan files in a knowledgebase?▼

A knowledgebase health check identifies orphan files, stale iterations, and metadata inconsistencies by scanning the repository structure to ensure coherent navigation and consistent curation across teams.

How do I normalize metadata across a knowledgebase repository?▼

To normalize metadata across a knowledgebase repository, apply a reflective tidy pass that detects structural issues, identifies inconsistencies, and reports suggested actions without executing destructive changes unless explicitly approved.

Can I fix broken links in my knowledgebase without losing data?▼

Yes, you can fix broken links safely because the tidy process reports changes and suggested actions without executing destructive mutations unless explicitly approved, ensuring your knowledgebase data remains protected during structural repairs.

Does the tidy health check support phase-based analysis for knowledgebases?▼

Yes, the tidy health check satisfies requirements for phase-based analysis and safe mutations by identifying structural issues and reporting results without executing destructive changes unless explicitly approved.

What is the best way to clean up stale content and orphan files in a knowledgebase?▼

The best way to clean up stale content and orphan files is to run a reflective tidy pass that detects structural issues, normalizes metadata, and generates a health summary with actionable recommendations for improving KB hygiene.

Why does my knowledgebase have metadata inconsistencies after structural updates?▼

Knowledgebase metadata inconsistencies occur when structural updates leave stale iterations and orphan files, which a reflective tidy pass detects and normalizes to restore coherent navigation and consistent curation across the repository.