knowledge-hygiene

Audit knowledge roots for stale links, orphan items, and archive drift.

4|Updated Mar 21, 2026

Search Tags:#audit #maintenance #links #knowledge #archive #hygiene #decay

Ready to run

npx skills add https://github.com/leocosta/octopus --skill knowledge-hygiene

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: knowledge-hygiene
Source: https://github.com/leocosta/octopus/tree/main/skills/knowledge-hygiene
Command: npx skills add https://github.com/leocosta/octopus --skill knowledge-hygiene

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Audit a registered knowledge root for decay — stale nodes, broken links, orphans, and concluded items outside their archive, and provide deterministic, reversible remediation.

Core Features & Use Cases

Audits docs/, knowledge/, and the octopus kr registry to surface decay signals, staleness, broken links, and orphaned nodes.
Reports findings in a readable format and can apply reversible fixes with --fix.
Supports per-root configuration to tailor staleness thresholds and archive rules.

Quick Start

Run the knowledge-hygiene audit to identify decay, stale nodes, and broken links, then apply reversible fixes as needed.

Frequently Asked Questions about knowledge-hygiene

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

FAQPage Schema

How do I audit a knowledge base for stale docs and broken links?▼

To audit a knowledge base for stale docs and broken links, run a knowledge hygiene audit. It deterministically checks docs/, knowledge/, and archive states to surface decay signals, staleness, and orphaned nodes, reporting findings for remediation.

Can I automatically fix orphaned nodes and archive drift?▼

You can automatically fix orphaned nodes and archive drift by running the audit with the --fix flag. This applies reversible remediation to concluded items outside their archive, ensuring safe and auditable corrections.

How do I configure staleness thresholds for a specific knowledge root?▼

You can configure staleness thresholds for a specific knowledge root using per-root configuration. This allows you to tailor archive rules and hygiene tests to determine when nodes are considered stale during the audit.

What is knowledge decay and how do I detect it?▼

Knowledge decay is the degradation of a knowledge base over time,表现为 stale nodes, broken links, orphans, and concluded items outside their archive. You detect it by running deterministic hygiene checks across registered knowledge roots.

Does the knowledge hygiene audit require any external dependencies?▼

The knowledge hygiene audit does not require external dependencies. It integrates directly with the octopus core registry to apply deterministic checks and provide safe, auditable results without needing additional components.