From e56affd8c89276c2793af2e1b513c6ba875e35ee Mon Sep 17 00:00:00 2001
From: arathiesh <arathiesh@ur-channel.com>
Date: Wed, 21 Jan 2026 12:35:01 -0500
Subject: [PATCH] feat: add agent-memory skill

---
 skills/agent-memory/SKILL.md | 66 ++++++++++++++++++++++++++++++++++++
 1 file changed, 66 insertions(+)
 create mode 100644 skills/agent-memory/SKILL.md

diff --git a/skills/agent-memory/SKILL.md b/skills/agent-memory/SKILL.md
new file mode 100644
index 0000000..8af278e
--- /dev/null
+++ b/skills/agent-memory/SKILL.md
@@ -0,0 +1,66 @@
+---
+name: agent-memory
+description: A hybrid memory system that provides persistent, searchable knowledge management for AI agents (Architecture, Patterns, Decisions).
+---
+
+# Agent Memory Skill
+
+This skill provides a persistent, searchable memory bank that automatically syncs with project documentation. It runs as an MCP server to allow reading/writing/searching of long-term memories.
+
+## Prerequisites
+
+- Node.js (v18+)
+
+## Setup
+
+1. **Clone the Repository**:
+   Clone the `agentMemory` project into your agent's workspace or a parallel directory:
+   ```bash
+   git clone https://github.com/webzler/agentMemory.git .agent/skills/agent-memory
+   ```
+
+2. **Install Dependencies**:
+   ```bash
+   cd .agent/skills/agent-memory
+   npm install
+   npm run compile
+   ```
+
+3. **Start the MCP Server**:
+   Use the helper script to activate the memory bank for your current project:
+   ```bash
+   npm run start-server <project_id> <absolute_path_to_target_workspace>
+   ```
+
+   *Example for current directory:*
+   ```bash
+   npm run start-server my-project $(pwd)
+   ```
+
+## Capabilities (MCP Tools)
+
+### `memory_search`
+Search for memories by query, type, or tags.
+- **Args**: `query` (string), `type?` (string), `tags?` (string[])
+- **Usage**: "Find all authentication patterns" -> `memory_search({ query: "authentication", type: "pattern" })`
+
+### `memory_write`
+Record new knowledge or decisions.
+- **Args**: `key` (string), `type` (string), `content` (string), `tags?` (string[])
+- **Usage**: "Save this architecture decision" -> `memory_write({ key: "auth-v1", type: "decision", content: "..." })`
+
+### `memory_read`
+Retrieve specific memory content by key.
+- **Args**: `key` (string)
+- **Usage**: "Get the auth design" -> `memory_read({ key: "auth-v1" })`
+
+### `memory_stats`
+View analytics on memory usage.
+- **Usage**: "Show memory statistics" -> `memory_stats({})`
+
+## Dashboard
+This skill includes a standalone dashboard to visualize memory usage.
+```bash
+npm run start-dashboard <absolute_path_to_target_workspace>
+```
+Access at: `http://localhost:3333`