aii-session-search

Searches distilled session records with full-text queries to locate past work sessions and track statuses.

Updated Aug 21, 2026
One-click install
npx skills add https://github.com/maestroventures/aiintegrator --skill aii-session-search-maestroventures
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: aii-session-search
Source: https://github.com/maestroventures/aiintegrator/tree/main/plugins/aii-blueprint/skills/aii-session-search
Command: npx skills add https://github.com/maestroventures/aiintegrator --skill aii-session-search-maestroventures

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When work spans many sessions over weeks, two things get lost: which session a decision or deliverable happened in, and which legs of a track are finished versus still running. This Skill answers both by searching the distilled session records written at the end of every session, so recall comes from stored data rather than memory. ## Core Features & Use Cases - Content Search: Runs a ranked PostgreSQL full-text query over session summaries, keywords, and titles, returning each match with a highlighted snippet, date, and the best route back into the original chat. - Track-Status Read: Lists every session leg of a named track with its status read directly from the record, so done-versus-active is answerable at a glance. - Reachability Gate: Verifies a live board connector exists before searching and stops with a plain explanation if none is available, never faking an empty result. - Use Case: Ask "which session did we decide the connection reset approach in?" and get back ranked matches with summary snippets and a reference or link back to that chat. ## Quick Start Ask which session we decided the database schema in, or which legs of the migration track are done.

Frequently Asked Questions about aii-session-search

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

FAQPage Schema
How do I find a past work session where something was decided?

Ask in recall-shaped language, such as "which session did we decide X in" or "find the chat where we built Y." The Skill runs a ranked full-text search over distilled session summaries, keywords, and titles, returning matches with snippets and a route back to the original chat.

How do I check which legs of a track are done?

Ask a status question like "which legs of the migration track are done?" The Skill reads the status column directly from each session record for that track and lists the legs in order, marking each as done or active.

Does session search store or search raw chat transcripts?

No. Only the distilled summary, keywords, and title written by the session handoff are stored and searched. Raw transcripts are never persisted, which is the privacy floor by design.

What happens if the session store is not reachable?

The Skill first checks for a live initiatives-board connector. If none answers, it stops and plainly says the session records cannot be reached on this seat, rather than returning a misleading empty result.

Why does session search not use semantic or embedding search?

The design deliberately uses PostgreSQL full-text search with a GIN index because it answers the real recall need without extra infrastructure. Embedding-based search is explicitly deferred as a separate later decision.

When should session search not be used?

Skip it for any forward-looking task with no look-back, such as building, drafting, or answering a fresh question. It only fires on recall-shaped language about past sessions.