| name | research-memory |
| description | Build a persistent, searchable knowledge base from articles, papers, documents, and notes using BlueColumn. Use when a user wants to save research for later retrieval, store articles or PDFs, build a second brain, or ask questions across their saved content. Triggers on phrases like "save this article", "store this paper", "add to my knowledge base", "what do I know about", "search my research", "recall what I saved about". Requires a BlueColumn API key (bc_live_*). |
Research Memory Skill
Turn articles, papers, and notes into a searchable knowledge base backed by BlueColumn.
Setup
Read TOOLS.md for the BlueColumn API key (bc_live_*). Keys are generated at bluecolumn.ai/dashboard. Store securely — never log or expose them.
Base URL: https://xkjkwqbfvkswwdmbtndo.supabase.co/functions/v1 (BlueColumn's official backend — bluecolumn.ai runs on Supabase Edge Functions)
Save Research
From URL (PDF or document):
curl -X POST .../agent-remember \
-H "Authorization: Bearer <key>" \
-d '{"file_url": "https://arxiv.org/pdf/...", "title": "Attention Is All You Need"}'
From text/paste:
curl -X POST .../agent-remember \
-H "Authorization: Bearer <key>" \
-d '{"text": "<article content>", "title": "Article Title - Source - Date"}'
Response: session_id, summary, key_topics[] — confirm to user what was stored.
Query Knowledge Base
curl -X POST .../agent-recall \
-H "Authorization: Bearer <key>" \
-d '{"q": "what have I saved about transformer attention mechanisms?"}'
Returns synthesized answer across all stored research + source citations.
Save a Quick Note
curl -X POST .../agent-note \
-H "Authorization: Bearer <key>" \
-d '{"text": "Interesting idea from paper: sparse attention reduces complexity to O(n sqrt(n))", "tags": ["transformers", "attention", "efficiency"]}'
Workflow
- User shares article URL, PDF URL, or pastes content
- Store via
/agent-remember with descriptive title (include source + date)
- Confirm: show summary + key topics extracted
- For queries →
/agent-recall with natural language question
- For quick observations →
/agent-note with relevant tags
Title Naming Convention
"<Topic> - <Source> - <YYYY-MM-DD>"
Example: "Sparse Attention - Arxiv - 2026-04-14"
Consistent naming improves recall accuracy over time.
See references/api.md for full API reference.
