SkillHub

workspace-maintenance

v1.0.0

Maintain workspace documentation hygiene and discoverability. Use when organizing markdown sprawl, updating doc indexes, archiving stale progress/status snapshots, generating dry-run cleanup candidate lists, and keeping memory/task control files aligned without deleting files automatically.

Sourced from ClawHub, Authored by Juici Frameworks

Installation

Please help me install the skill `workspace-maintenance` from SkillHub official store. npx skills add houseofjuici/workspace-maintenance

Workspace Maintenance

Run a non-destructive maintenance cycle that keeps docs findable and the root clean.

Execute Maintenance Cycle

  1. Run dry-run retention audit script:
  2. scripts/archive-retention-audit.sh
  3. Regenerate or refresh docs index if categories changed.
  4. Ensure active control files remain in root (do not move them).
  5. Move stale snapshot/status/progress docs to archive buckets.
  6. Update active task tracker with maintenance completion timestamp.
  7. Produce human review list for deletion candidates (never delete automatically).

Constraints

  • Never delete files automatically.
  • Never move identity/control files out of root.
  • Keep changes reversible (moves + manifests).
  • Always produce a dry-run candidate report.

Archive Buckets

  • docs/archive/meridian-snapshots/
  • docs/archive/general-progress/
  • docs/archive/session-hygiene/

Required Outputs

  • Updated dry-run candidates file in archive
  • Updated active task status entry
  • Move manifest for any batch relocation
  • Brief completion summary

Use Bundled Script

  • scripts/archive-retention-audit.sh generates current dry-run deletion candidates.