episodic-archiver

Embed conversation turns and store them in ArangoDB for search and retrieval.

1|Updated Nov 12, 2025
One-click install
npx skills add https://github.com/grahama1970/fetcher --skill episodic-archiver
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: episodic-archiver
Source: https://github.com/grahama1970/fetcher/tree/main/.agents/skills/episodic-archiver
Command: npx skills add https://github.com/grahama1970/fetcher --skill episodic-archiver

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Managing long-running conversations is hard: you lose context, can't trace decisions, and memory decays. This skill archives full transcripts, embeds turns for fast search, and stores analysis in ArangoDB, enabling retrieval, auditing, and memory-assisted workflows.

Core Features & Use Cases

  • Embeds and stores each message turn for searchable memory.
  • Categorizes turns and tracks metadata for analysis.
  • Stores data in ArangoDB to support auditing, recall, and user story preservation.
  • Optional quality checks via edge verification for critical episodes.

Quick Start

Provide a transcript JSON to archive and run the archive script to store it in ArangoDB.

Frequently Asked Questions about episodic-archiver

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

FAQPage Schema
How do I archive and search long-running conversation histories?

You embed message turns and store full transcripts in ArangoDB to index conversation histories. This applies timestamps and category labels, enabling rapid search, retrieval, and auditability for long-running sessions.

What is the best way to index chat transcripts for memory-assisted retrieval?

The best way to index chat transcripts for memory-assisted retrieval is by generating per-turn embeddings and storing them with dedupe keys in ArangoDB. This preserves user stories and enables searchable memory across sessions.

Does archiving conversations in ArangoDB require an external embedding model?

Yes, archiving conversations in ArangoDB requires an embedding model to process message turns for search. It also relies on optional external categorization services to apply category labels and track metadata for analysis.

Can I apply quality checks to archived episodic conversations?

You can apply quality checks to archived episodic conversations using optional edge verification for critical episodes. This supports auditing and recall within memory-assisted workflows while maintaining data accuracy.

How do I start archiving a transcript JSON for auditability?

To start archiving a transcript JSON for auditability, provide the transcript data to the archive script and run it to store the conversations in ArangoDB. This preserves full context and metadata for later retrieval.

Why should I use per-turn embeddings for conversation archiving?

Using per-turn embeddings for conversation archiving enables rapid search and retrieval of specific dialogue points within long-running sessions. It solves context loss and memory decay by storing searchable metadata in ArangoDB.