journal-search

Search markdown journal entries using BM25 and SQLite FTS5 indexing.

6|Updated Apr 5, 2026
One-click install
npx skills add https://github.com/icepeng/agentchan --skill journal-search
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: journal-search
Source: https://github.com/icepeng/agentchan/tree/main/example_data/library/templates/memory-chat/skills/journal-search
Command: npx skills add https://github.com/icepeng/agentchan --skill journal-search

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and assets (resource) components.

What problem does it solve?

This Skill enables quick retrieval of relevant past journal entries by keyword using advanced search techniques.

Core Features & Use Cases

  • Search Past Events: Retrieve journal entries related to specific keywords or phrases from lengthy records.
  • Contextual Recall: Find entries based on relationships, emotions, or themes for narrative consistency.
  • Use Case: A writer wants to quickly locate all journal notes mentioning "Marek" and "lighthouse" to reference past events in a story.

Quick Start

Use the search function to find journal entries mentioning "Marek and lighthouse" within your journal archive.

Frequently Asked Questions about journal-search

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

FAQPage Schema
How do I search past journal entries by keyword relevance?

To search journal entries by keyword relevance, this Skill indexes markdown files using SQLite with FTS5, applying BM25 ranking and grep fallback to retrieve matching snippets and narratives quickly.

What is the best way to retrieve text from markdown journals for narrative consistency?

The best way to retrieve text from markdown journals is using BM25 relevance ranking over a SQLite FTS5 index, which surfaces detailed snippets and relationships between themes for narrative consistency.

Can I use complex keyword queries to find specific events in journal files?

Yes, you can use complex keyword queries to find specific events in journal files; the Skill supports advanced search techniques to retrieve related past entries from lengthy markdown records.

How does BM25 search work with markdown files?

BM25 search works with markdown files by indexing their text content into a SQLite FTS5 database, enabling fast full-text searches that return relevant snippets based on keyword frequency and proximity.

Do I need SQLite to perform text searches on my journal archive?

You do not need to manually configure SQLite to perform text searches; the Skill leverages SQLite with FTS5 internally to build an index and relies on grep fallback to ensure relevant results.

Why does my journal search not working when querying multiple keywords?

If a journal search is not working with multiple keywords, the Skill relies on BM25 ranking and grep fallback, which may return no results if the exact terms do not exist within the indexed markdown files.