hygiene-inspector

Validate knowledge base folder structures against predefined rules and generate reports.

Updated Apr 15, 2026
One-click install
npx skills add https://github.com/juliuss1907/knowledge-base --skill hygiene-inspector
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hygiene-inspector
Source: https://github.com/juliuss1907/knowledge-base/tree/main/.hermes/skills/hygiene-inspector
Command: npx skills add https://github.com/juliuss1907/knowledge-base --skill hygiene-inspector

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires os, json, re, collections, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the validation of knowledge base folder structures and generates detailed reports, ensuring compliance with predefined rules and standards.

Core Features & Use Cases

  • Folder Structure Validation: Checks the folder structure against a predefined whitelist, ensuring only allowed paths exist.
  • Naming Conventions Enforcement: Ensures folder and file names follow specific naming conventions.
  • Orphan Detection: Identifies misplaced files and empty folders.
  • Report Generation: Generates detailed reports listing all issues found during the validation process.
  • Use Case: This Skill can be used daily to ensure the integrity of a knowledge base's folder structure, or on demand to validate specific changes or new content.

Quick Start

Run the hygiene-inspector skill to validate the folder structure of your knowledge base.

Frequently Asked Questions about hygiene-inspector

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

FAQPage Schema
How do I validate my knowledge base folder structure for compliance?

Knowledge base folder structure validation checks directories against predefined rules and naming conventions. This skill automates validation using Python regex pattern matching and directory traversal to identify orphan files, empty folders, and non-compliant paths.

What is the best way to automate report generation for knowledge base compliance?

Automating knowledge base compliance report generation requires validating folder structures against predefined rules. This skill traverses directories using Python, applies regex pattern matching, and outputs detailed reports listing all structural issues and naming convention violations found.

Do I need Python to check folder naming conventions in my knowledge base?

Yes, Python is required to check folder naming conventions in your knowledge base. The validation process relies on Python libraries for directory traversal and regex pattern matching to enforce naming rules and detect misplaced files.

How does orphan detection work for files in a knowledge base directory?

Orphan detection for files in a knowledge base directory works by traversing the folder structure and identifying misplaced files and empty folders. The skill compares existing paths against a predefined whitelist to flag any files that do not belong in the allowed structure.

Can I use this validation tool for daily knowledge base integrity checks?

Yes, you can use this validation tool for daily knowledge base integrity checks. It is designed to run on demand or daily to ensure folder structure compliance, enforce naming conventions, and generate reports on any structural issues found.

What are the limitations of using regex pattern matching for folder structure validation?

Regex pattern matching for folder structure validation is limited to checking names and paths against predefined rules. It requires an exact whitelist of allowed paths and cannot validate the semantic content or logical relationships of the files within the knowledge base directories.