MonoClaw

Curator

The Curator is a background process that maintains your skills catalog. It ensures your skills stay relevant, accurate, and organized without manual intervention.

What the Curator does

Usage tracking

The Curator records:

  • How often each skill is loaded
  • Which conversations use which skills
  • Success/failure rates per skill

Staleness detection

Skills are flagged as stale when:

  • They haven't been used in 30 days
  • Their content references outdated tools or APIs
  • They conflict with newer skills

Archival

Stale skills are moved to ~/.monoclaw/skills/.archive/ instead of being deleted. You can restore them anytime.

LLM-driven review

Periodically, the Curator asks Mona to review archived skills:

  • "Is this skill still useful?"
  • "Does it overlap with newer skills?"
  • "Should it be updated or permanently removed?"

Configuration

# ~/.monoclaw/config.yaml
curator:
  enabled: true
  review_interval: "7d"      # How often to run reviews
  staleness_threshold: "30d"  # Time before a skill is archived
  auto_archive: true          # Automatically archive stale skills
  auto_delete: false          # Permanently delete after archival period

Manual curation

Run a review on demand:

monoclaw skills curate

This triggers:

  1. Usage analysis
  2. Staleness detection
  3. Archival of stale skills
  4. LLM review of archived skills

Reviewing archived skills

List archived skills:

monoclaw skills list --archived

Restore a skill:

monoclaw skills restore my-old-skill

Permanently delete:

monoclaw skills delete my-old-skill --permanent

Curator reports

Generate a report of your skills catalog:

monoclaw skills report

Output:

Skills Catalog Report
=====================
Active: 12
Archived: 3
Most used: kubernetes (45 loads), obsidian (32 loads)
Stale: 1 (django-deploy)
Recommendations:
  - Update django-deploy (references Django 4.x, latest is 5.x)
  - Merge email-triage and gmail-management (85% overlap)

Best practices

  • Keep the Curator enabled — It prevents skill sprawl
  • Review recommendations — The LLM often spots overlaps you miss
  • Don't auto-delete — Keep archived skills until you're sure they're obsolete
  • Version your skills — Makes it easier for the Curator to track changes