session-librarian

Organize agent session libraries by finding, renaming, archiving, and pruning sessions.

1|Updated Aug 11, 2026
One-click install
npx skills add https://github.com/Chia1104/agent-air --skill session-librarian-chia1104
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: session-librarian
Source: https://github.com/Chia1104/agent-air/tree/main/skills/hermes/productivity/session-librarian
Command: npx skills add https://github.com/Chia1104/agent-air --skill session-librarian-chia1104

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Over time an agent's session library fills with untitled, duplicated, and stale conversations, making it hard to find past decisions or resume prior work. This Skill turns plain-language requests into a safe, reviewable cleanup and organization workflow for that library. ## Core Features & Use Cases - Topic-based discovery: Search session content with session_search (FTS5) and filter metadata (age, source, cost, workspace) via hermes sessions list to answer "what did we decide about X?" - Safe mutation workflow: Rename, archive (reversible soft-hide), export, and delete sessions only after presenting a plan table and running destructive commands with --dry-run first. - Parallel workstreams: Split work into one session per ticket using delegate_task, then synthesize subagent summaries. - Use Case: Ask "find my sessions about Q3 pricing, keep the useful ones, and clean up the duplicates" and receive a summarized plan of renames, archives, and proposed deletions before anything changes. ## Quick Start Ask the agent to find all sessions about a topic, summarize their decisions, and propose stale duplicates for archiving.

Frequently Asked Questions about session-librarian

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

FAQPage Schema
How do I find past agent sessions about a specific topic?▼

Use session_search with topic keywords and a limit of 5-10, varying phrasing such as feature name, symptom, or project name. For metadata filters like age or source, use hermes sessions list with flags such as --source telegram instead.

How to safely delete old agent sessions without losing content?▼

Prefer archive over delete since archiving is a reversible soft-hide. Before deleting anything valuable, run hermes sessions export --format md as a backup, and always execute destructive commands with --dry-run first, then --yes only after confirmation.

What is the difference between archiving and deleting sessions?▼

Archiving hides sessions from default listings but keeps them in the database, viewable with --include-archived. Deleting via hermes sessions delete or prune permanently removes them, which is why dry-run and export backups are required first.

Can I split one task into multiple parallel agent sessions?▼

Yes, use delegate_task with one task per workstream rather than trying to drive other live sessions. Each subagent runs in its own session automatically, and each delegation transcript remains searchable later via session_search.

Why does session_search not filter sessions by date or cost?▼

session_search searches message content only, not metadata. Age, cost, source, token, and workspace filters live in the hermes sessions list CLI, so combine both tools when a request mixes content and metadata criteria.