Skip to content
Skills Library
AI & agents · Automation

Agent Memory

/Agent Memory

Give your agent persistent cross-session memory — recall what went wrong on similar tasks before starting, then capture whether the work succeeded or failed so repeated mistakes auto-promote into prevention rules. Runs locally via the ThumbGate MCP server (recall, capture_feedback, prevention_rules, feedback_stats) — no API key needed. Use when the user says "recall", "what went wrong last time", "remember this for next time", "capture feedback", "thumbs up/down on that", or at the start of a new task or session. Do NOT use when the user wants to force one specific mistake into an enforced blo

Licence
MIT
Last repository change
27.10.2026

Assessment and security

90/ 100Class: good
Format15 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
3
Deprecation

No signals detected. Repository changed on 27.10.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Give your agent persistent cross-session memory — recall what went wrong on similar tasks before starting, then capture whether the work succeeded or failed so repeated mistakes auto-promote into prevention rules. Runs locally via the ThumbGate MCP server (recall, capture_feedback, prevention_rules, feedback_stats) — no API key needed. Use when the user says "recall", "what went wrong last time", "remember this for next time", "capture feedback", "thumbs up/down on that", or at the start of a new task or session. Do NOT use when the user wants to force one specific mistake into an enforced blo

Triggers from the description

recallwhat went wrong last timeremember this for next timecapture feedbackthumbs up/down on that
Original author description

Give your agent persistent cross-session memory — recall what went wrong on similar tasks before starting, then capture whether the work succeeded or failed so repeated mistakes auto-promote into prevention rules. Runs locally via the ThumbGate MCP server (recall, capture_feedback, prevention_rules, feedback_stats) — no API key needed. Use when the user says "recall", "what went wrong last time", "remember this for next time", "capture feedback", "thumbs up/down on that", or at the start of a new task or session. Do NOT use when the user wants to force one specific mistake into an enforced blo

How it works

  1. Setup
  2. When to Use
  3. Workflow
  4. Available MCP Tools
  5. MCP Profiles
  6. How Prevention Rules Work
  7. Links
Original SKILL.md headings · 94 lines, 481 words
SKILL.md preview
---
name: Agent Memory
description: Give your agent persistent cross-session memory — recall what went wrong on similar tasks before starting, then capture whether the work succeeded or failed so repeated mistakes auto-promote into prevention rules. Runs locally via the ThumbGate MCP server (recall, capture_feedback, prevention_rules, feedback_stats) — no API key needed. Use when the user says "recall", "what went wrong last time", "remember this for next time", "capture feedback", "thumbs up/down on that", or at the start of a new task or session. Do NOT use when the user wants to force one specific mistake into an enforced block gate (use the thumbgate-guard skill), to list rules that already exist (thumbgate-rules), or to check ThumbGate wiring (thumbgate-doctor).
---

# Agent Memory

Give your agent persistent memory across sessions. Before starting any task, recall what went wrong last time. After completing work, capture whether it succeeded or failed. Prevention rules are auto-generated from repeated mistakes.

## Setup

Add the MCP server (one-time):

```bash
claude mcp add thumbgate -- npx -y thumbgate serve
```

No API key needed. All data stays local.

## When to Use

- Starting a new task or session — recall past context first
- After completing work that succeeded or failed — capture feedback
- When the agent keeps making the same mistake — check prevention rules

## Workflow

### Step 1: Recall past context (do this FIRST on every task)

Call the `recall` MCP tool with a description of your current task. The tool returns:

- Past feedback relevant to this task (vector similarity search)
- Active prevention rules (auto-generated from repeated failures)
- Recent feedback summary with approval rate

Read the prevention rules carefully. These are patterns that failed before — follow them.

### Step 2: Do your work

Complete the task as normal. Keep track of what you did and whether it worked.

### Step 3: Capture feedback

Call the `capture_feedback` MCP tool:

**If succeeded:**
- signal: `up`
- context: What worked and why
- tags: Category labels

**If failed:**
- signal: `down`
- context: What you were trying to do
- whatWentWrong: Specific failure description
- whatToChange: How to avoid this next time
- tags: Category labels

Vague feedback like "it failed" will be rejected. Be specific.

### Step 4: Check improvement (optional)

Call the `feedback_stats` MCP tool to see approval rate, top failure domains, and whether the agent is trending better or worse.

## Available MCP Tools

| Tool | What it does |
|------|-------------|
| `recall` | Search past feedback and prevention rules for current task |
| `capture_feedback` | Record what worked or failed with structured context |
| `prevention_rules` | View auto-generated rules from repeated mistakes |
| `feedback_stats` | Approval rate, trend analysis, top failure domains |
| `feedback_summary` | Human-readable summary of recent signals |

## MCP Profiles

| Profile | Tools | Use case |
|---------|-------|----------|
| `essential` | 5 core tools | Default — start here |
| `commerce` | 6 tools + commerce_recall | Agentic commerce agents |
| `default` | 12 tools | Full pipeline including DPO export |

Set profile: `THUMBGATE_MCP_PROFILE=essential npx thumbgate serve`

## How Prevention Rules Work

1. Agent makes mistake A → you capture `down` feedback
2. Agent makes mistake A again → you capture `down` feedback again
3. System detects pattern → auto-generates prevention rule: "NEVER do A"
4. Next session → `recall` returns the rule → agent follows it

This is the core value. The agent doesn't learn — but it reads the rules and follows them.

## Links

- [GitHub](https://github.com/IgorGanapolsky/thumbgate)
- [npm](https://www.npmjs.com/package/thumbgate)
- [MCP Registry](https://registry.modelcontextprotocol.io)

Versions

The database has no other skills named Agent Memory.

Identical content appears in 1 other GitHub folders. We show one copy with the highest score.

Database snapshot: 13.11.2026 · package version 2258233a5d20 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100agent-memory
    Give an agent persistent semantic memory with @three-ws/agent-memory. Use when code needs to remember facts across sessions, recall them by meaning, read the entity graph, or curate an agent's working context.
  • 100thumbgate
    Pre-action checks for AI coding agents — capture thumbs-up/down feedback, generate prevention rules, and block known-bad patterns before they execute. Use when setting up ThumbGate, capturing feedback on agent actions, checking active prevention rules, debugging blocked actions,…
  • 95cpersona-memory
    Give Claude persistent, searchable memory across sessions using the CPersona MCP server. Use this skill whenever the user wants Claude to remember things between conversations, asks to install or set up CPersona / a memory server, or when CPersona tools are available and the…
  • 100thumbgate-feedback
    Capture thumbs up/down feedback into structured memories and prevention rules. Require one sentence of why before claiming memory promotion. Use when user gives explicit quality signals about agent work (e.g. "that worked", "that failed", "thumbs up/down"). Do NOT use for…
  • 100persistent-memory
    Gives an agent durable project memory across sessions by reading and updating a small set of external Markdown files (profile, projects, decisions, tasks, session log, sources) instead of relying on chat history. Use when work spans more than one session, when a project has…
  • 100cowork-mem
    Persistent memory across Cowork sessions. Use this skill at the START of every session to recall what happened before, and throughout any session to save important context — decisions, file changes, insights, errors, tool usage. Trigger whenever: the user says "remember this",…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.