Skip to content

feat(curator): user-facing CLI for skill usage stats, archive/restore, and prune #19384

@teknium1

Description

@teknium1

Summary

Expose the curator's skill-usage data and lifecycle operations via hermes skills subcommands so users can inspect and manage skill health from the CLI.

Motivation

The curator (PR #bc79e227e) already tracks per-skill usage in the skill_usage SQLite table and performs background maintenance. Users currently have no direct way to:

  • See which skills they actually use vs. which are dead weight
  • Manually archive/restore a skill without deleting it
  • Prune skills unused for N days on demand

Credit: @fathah's PR #4406 proposed this CLI surface alongside a larger (now-redundant) ranking/tracking rewrite. The ranking/tracking pieces are subsumed by the shipped curator, but the CLI surface is genuinely net-new.

Proposed surface

```
hermes skills stats # per-skill view/invoke counts, last-used, days-idle
hermes skills archive # move skill to archived/ (excluded from prompt)
hermes skills restore # move back from archived/
hermes skills prune [--days N] # list+confirm removal of skills idle >= N days
```

Notes

  • Must integrate with the curator's existing skill_usage table, not introduce a parallel store.
  • `archive` should respect pinning (PR feat(skills): refuse skill_manage writes on pinned skills #17562) — pinned skills cannot be archived.
  • `prune` must offer a dry-run and explicit confirmation; default `--days` should be conservative (e.g. 90).
  • Do NOT add per-message keyword-relevance ranking to the system prompt — that would invalidate the system prompt cache every turn.

Metadata

Metadata

Assignees

No one assigned

    Labels

    P3Low — cosmetic, nice to havecomp/cliCLI entry point, hermes_cli/, setup wizardtool/skillsSkills system (list, view, manage)type/featureNew feature or request

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions