Back to Home
Open Source

XiaoyaoClaw Workspace Auditor

A read-only "quality inspector" — 5 health checks (layout, tasks, memory, KB index, junk), tiered report + fix suggestions. Never touches files.

Product Introduction

OpenClaw Workspace Auditor tackles five slow-burn workspace problems that hide in plain sight: non-md files at the root, missing standard dirs; PROGRESS.md-less / status-stale / zombie tasks; memory-log gaps and missing MEMORY.md; KB index blind spots (new knowledge/ files not indexed); tmp/ junk and oversized files. Solution: one zero-dep script, 5 check categories, tiered report. Never modifies / deletes / moves files — fixes only on your confirmation. Categories: layout (initializer rules), task health (tracker PROGRESS.md), memory health, KB health (kb-retriever index), junk files. 🔴 violation / 🟡 warning / 🟢 ok / ⏭️ skipped — every line carries a fix suggestion. Missing sister skills → skip + hint, no false positives. Markdown for humans, JSON for machines, cron-friendly. Pure Python stdlib, no third-party packages, no API key, no network.

XiaoyaoClaw Workspace Auditor poster

Core Features

  • Read-only — never modifies/deletes/moves files; fixes need explicit confirmation
  • 5 health checks — layout (initializer), task health (tracker), memory health, KB health (kb-retriever index), junk files
  • Tiered report — 🔴 violation / 🟡 warning / 🟢 ok / ⏭️ skipped, every line with fix suggestion
  • Zero deps — Python stdlib only, no third-party, no API key, no network
  • Progressive deps — skip sister-skill checks with a hint; no false positives, deeper when more skills installed
  • Cross-platform — Windows / macOS parity (pure Python)
  • Dual output — Markdown for humans, JSON for machines, cron-friendly

Use Cases

OpenClaw / XiaoyaoClaw usersPeriodic health checks for multi-skill workspacesTroubleshooting KB index gaps / zombie tasksCron-driven automated health workflows

Tags

#OpenClaw#AI Skill#Workspace audit#Health check#Read-only scan#MIT