Agent skill

Forgetful Remember

by ScottRBK in ScottRBK/forgetful

Decides where a piece of knowledge belongs in the Forgetful memory server, checks for existing entries first, then creates and links it without deleting anything.

MITAuto-check passedAgent Workflows

Install Forgetful Remember

skills CLI
$ npx skills add ScottRBK/forgetful --skill forgetful-remember -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install ScottRBK/forgetful forgetful-remember --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/ScottRBK/forgetful.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/forgetful-remember .claude/skills/forgetful-remember && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
forgetful-remember
GitHub stars
301
Token cost
~1.3k tokens
SKILL.md length
619 words
Files
1
Skills in repo
10
Repo updated
First seen
Licence
MIT

At a glance

Decides where a piece of knowledge belongs in the Forgetful memory server, checks for existing entries first, then creates and links it without deleting anything.

  • Works in 6 steps: Route the type → Resolve the project → Query before create → …
  • Saving a decision, solution or preference so future sessions can find it
  • SKILL.md covers Invoking operations, Step 1 — Route the type, Step 2 — Resolve the project and Step 3 — Query before create, plus 3 more sections
  • Calls git

What it does

Capture is a sequence rather than a single call. The agent routes the content to the right store: a memory for a single fact, decision or preference, a document plus short entry memories for analysis longer than roughly 300 words, a code artifact, or a hand-off to the entity, procedure or file skills. It then confirms which project the write belongs to, deriving a candidate from the git remote and asking when unsure.

Before creating, it queries for overlapping memories and acts on each hit: link and skip a duplicate, update with your confirmation, mark an obsolete one superseded and add a replacement, or create a new memory and link the two. Removal and rewriting happen by supersession only. Operations run through the MCP execute_forgetful_tool or the forgetful CLI.

When your agent uses it

  • Saving a decision, solution or preference so future sessions can find it
  • Storing a long analysis or guide as a document with short memories pointing to it
  • Recording a correction that supersedes an older memory

Example prompts

  • “Remember that we chose Postgres over MongoDB for the orders service, and why.”
  • “Save this debugging write-up so future sessions can find it.”
  • “The old note about the retry limit is wrong now. Replace it with the new setting.”

Requirements

  • A running Forgetful memory server reachable through MCP or the forgetful CLI
  • Pre-approved tools (allowed-tools): mcp__forgetful__discover_forgetful_tools, mcp__forgetful__how_to_use_forgetful_tool, mcp__forgetful__execute_forgetful_tool, Bash(forgetful:*)

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. Route the type
  2. Resolve the project
  3. Query before create
  4. Create atomically
  5. Link
  6. Announce

What it can do on your machine

Read from SKILL.md and the folder at commit 7afcbf1. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • mcp__forgetful__discover_forgetful_tools
    • mcp__forgetful__how_to_use_forgetful_tool
    • mcp__forgetful__execute_forgetful_tool
    • Bash(forgetful:*)

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • git

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Forgetful Remember loads about 1.3k tokens when it runs. Until then it costs about 89 tokens; SKILL.md has 619 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~89
When it runs · the whole SKILL.md, loaded when a task matches
~1.3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from ScottRBK/forgetful at commit 7afcbf1, republished under its MIT licence (© ScottRBK). 619 words, ~1,329 tokens.

Download SKILL.mdSave it as .claude/skills/forgetful-remember/SKILL.md (or your agent's skills folder).
name
forgetful-remember
description
Remember knowledge worth keeping — a decision made, a solution found, a preference stated, a pattern confirmed. Use when work surfaces something future sessions will need, or the user asks to remember something. Routes content to the right store (memory, document, code artifact, entity, procedure, file) and enforces query-before-create.
allowed-tools
mcp__forgetful__discover_forgetful_tools, mcp__forgetful__how_to_use_forgetful_tool, mcp__forgetful__execute_forgetful_tool, Bash(forgetful:*)
license
MIT
tags
memory, capture, curation, knowledge-management

Remembering knowledge in Forgetful

Capture is a sequence, not a single call: route the content to the right store, ground it in a project, check what already exists, then create atomically and link. Removal and rewriting happen by supersession only — a memory does not become less true because it hasn't been queried lately.

Invoking operations

Operations are named by registry name (query_memory, create_memory, ...). Invoke via whichever surface this agent has:

  • MCP: execute_forgetful_tool(tool_name="create_memory", arguments={...})
  • CLI: forgetful call create_memory --args '{"title": "..."}' --json

Get any operation's schema at runtime: how_to_use_forgetful_tool (MCP) or forgetful tools info <operation> (CLI) — schemas are deliberately not repeated here.

Step 1 — Route the type

The content is...Store asWhere
A single fact, decision, or preferenceMemorythis skill, step 4
Detailed analysis or a guide (>300 words)Document + entry memoriesthis skill, step 4
Reusable codeCode artifactthis skill, step 4
A person, org, device, product, componentEntityforgetful-entities
Step-by-step procedural knowledgeSkillforgetful-procedures
Binary content (image, PDF, asset)Fileforgetful-files
A goal decomposing into steps / a work itemPlan / Taskfeature-flagged; check discovery

Done when: exactly one type is chosen, and routed-away types are handled by their skill.

Step 2 — Resolve the project

Every write needs a deliberate project decision. Derive the candidate from the repo: git remote get-url origin → owner/repo → list_projects with repo_name. When no project matches, create one or ask the user; when several could apply, ask.

Done when: a real project_id is confirmed — discovered or user-chosen, never assumed.

Step 3 — Query before create

Search for overlapping knowledge using the candidate's own essence as the query (query_memory with query and query_context). Classify every relevant hit:

Existing memory is...Action
Still accurate and covers the pointLink to it if related; skip creating a duplicate
Right but missing the new detailUpdate it — confirm with the user first
Contradicted by the new knowledgeMark obsolete (confirm first) + create replacement
Overlapping but a distinct conceptCreate new, then link_memories both

Create and link freely; update_memory and mark_memory_obsolete rewrite history, so those two always get user confirmation before executing.

Done when: every hit is classified and the create/update/skip decision is explicit.

Show full SKILL.md (265 more words)Show less

Step 4 — Create atomically

The atomicity test, before writing: Can the title say it in ~10 words? Is it self-contained without reading other memories? Is it ONE decision, fact, or pattern? A sprawling "Project X overview" fails the test — split it.

  • Ideal content is 200–400 words. Limits: title ≤200 chars, content ≤2000, context ≤500, keywords ≤10, tags ≤10.
  • Set importance from the rubric below. About 70% of memories belong at 7–8; reserve 9–10.
BandUse for
9–10Foundational: personal facts, architectural principles in constant use
8–9Critical solutions, major decisions
7–8Useful patterns, strong preferences, tool choices, standard implementations
6–7Milestones, minor context
5Noise floor: bulk/automated captures meant to stay out of normal recall
  • Stamp provenance when derived from source material: source_repo, source_files, source_url.

Long-form variant: content over ~300 words becomes create_document, then 3–7 atomic memories as entry points, each linked to the document via document_ids. Reusable code becomes create_code_artifact, with a memory pointing at it when the decision behind the code matters too.

Done when: the object exists, atomic, scored, and provenance-stamped where applicable.

Auto-linking connects each new memory to its nearest neighbours (similarity ≥ 0.7 by default). Review what it picked up, then add link_memories manually only for the four kinds embeddings miss: cross-domain connections, prerequisite chains, contrast (this-not-that), and evolution (old approach → new approach).

Done when: auto-links reviewed and any of the four manual kinds added.

Step 6 — Announce

This skill is the single source of truth for the announcement convention. After saving with importance ≥ 7:

💾 Saved to memory: "<title>"
   Tags: <tags>
   Related: <linked memory titles>

Done when: the user can see what was saved and how it connected.

© ScottRBK, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/forgetful-remember of ScottRBK/forgetful.

Open the folder on GitHubat commit 7afcbf1

Compare with similar skills

Forgetful Remember next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Forgetful Remember compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Forgetful Remember this skillScottRBK/forgetful301—~1.3kAutomated safety check: PassMIT
MemPalace Setup and OperationMemPalace/mempalace59k—~2.2kAutomated safety check: PassMIT
Qmdbreferrari/obsidian-mind4.9k—~1.7kAutomated safety check: PassMIT
Context Mode Searchmksglu/context-mode26k—~250Automated safety check: PassCustom licence
remindb Memory Writerradimsem/remindb129—~2kAutomated safety check: PassMIT
Ogham Maintainogham-mcp/ogham-mcp115—~1.1kAutomated safety check: PassMIT

Similar skills

  • Installs and configures MemPalace as a private local palace, a shared-brain hub or a client of an existing hub, including MCP registration and version-correct initialization.

    59k GitHub stars~2.2k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Qmd

    breferrari/obsidian-mind

    Search the vault using QMD semantic search. An agent skill from breferrari/obsidian-mind.

    4.9k GitHub stars~1.7k tokensUpdated 2 days ago
    Agent WorkflowsAuto-check passed
  • Context Mode Search

    mksglu/context-mode

    Search context-mode's persistent FTS5 knowledge base for previously indexed local project content, documentation, or session memory. Trigger…

    26k GitHub stars~250 tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • remindb Memory Writer

    radimsem/remindb

    Guides an agent writing to a remindb memory server: structured notes go in as files parsed into a node tree, single text facts go in through MemoryWrite.

    129 GitHub stars~2k tokensUpdated 2 mo ago
    Agent WorkflowsAuto-check passed
  • Ogham Maintain

    ogham-mcp/ogham-mcp

    Admin and maintenance workflows for Ogham shared memory. An agent skill from ogham-mcp/ogham-mcp.

    115 GitHub stars~1.1k tokensUpdated 8 days ago
    Agent WorkflowsAuto-check passed
  • Ogham Recall

    ogham-mcp/ogham-mcp

    Smart retrieval from Ogham shared memory. An agent skill from ogham-mcp/ogham-mcp.

    115 GitHub stars~1k tokensUpdated 8 days ago
    Agent WorkflowsAuto-check passed

More from ScottRBK/forgetful

All 10 skills in this repo
  • Forgetful CLI Setup

    ScottRBK/forgetful

    Installs and connects the Forgetful CLI in local or remote mode, sets up token auth for CI, and proves the setup with a real round-trip call.

    301 GitHub stars~898 tokensUpdated yesterday
    Auto-check: notes
  • Forgetful Repo Encoding

    ScottRBK/forgetful

    Encodes a repository into the Forgetful knowledge base as a project, entities, atomic memories and documents, so a second run updates instead of duplicating.

    301 GitHub stars~1k tokensUpdated yesterday
    Auto-check passed
  • Forgetful Entity Modeling

    ScottRBK/forgetful

    Models people, organisations, devices, products and system components as entities in a Forgetful knowledge graph, then links memories and relationships to them.

    301 GitHub stars~836 tokensUpdated yesterday
    Auto-check passed
  • Explores the Forgetful memory graph in phases, walking memories, entities and relationships to answer cross-project and entity-centred questions.

    301 GitHub stars~898 tokensUpdated yesterday
    Auto-check passed
  • Forgetful File Storage

    ScottRBK/forgetful

    Stores screenshots, PDFs, diagrams, fonts and other binary files in the Forgetful knowledge base, with a retrieval-friendly description and an attachment route.

    301 GitHub stars~618 tokensUpdated yesterday
    Auto-check passed
  • Forgetful MCP Client Setup

    ScottRBK/forgetful

    Connects an MCP client to the Forgetful memory server over stdio or HTTP, then confirms the link works with discovery and round-trip calls.

    301 GitHub stars~682 tokensUpdated yesterday
    Auto-check passed

Questions about Forgetful Remember

What does Forgetful Remember do?

Decides where a piece of knowledge belongs in the Forgetful memory server, checks for existing entries first, then creates and links it without deleting anything. Capture is a sequence rather than a single call. The agent routes the content to the right store: a memory for a single fact, decision or preference, a document plus short entry memories for analysis longer than roughly 300 words, a code artifact, or a hand-off to the entity, procedure or file skills.

When should I use Forgetful Remember?

Forgetful Remember fits situations like: saving a decision, solution or preference so future sessions can find it; storing a long analysis or guide as a document with short memories pointing to it; recording a correction that supersedes an older memory.

How do I install Forgetful Remember in Claude Code?

Run `npx skills add ScottRBK/forgetful --skill forgetful-remember -a claude-code`. Or copy the skill folder (skills/forgetful-remember in ScottRBK/forgetful) into .claude/skills/forgetful-remember in your project. Claude Code loads it when a task matches its description.

How do I install Forgetful Remember in Codex?

Run `npx skills add ScottRBK/forgetful --skill forgetful-remember -a codex`. Or copy the skill folder (skills/forgetful-remember in ScottRBK/forgetful) into .agents/skills/forgetful-remember in your project. Codex loads it when a task matches its description.

Can I use Forgetful Remember in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add ScottRBK/forgetful --skill forgetful-remember -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/forgetful-remember, .gemini/skills/forgetful-remember, .github/skills/forgetful-remember and .opencode/skills/forgetful-remember in your project.

What does Forgetful Remember need to run?

Going by SKILL.md and its folder, Forgetful Remember needs the command-line tools its instructions call (git). Our summary lists: A running Forgetful memory server reachable through MCP or the forgetful CLI. Its frontmatter pre-approves these tools: mcp__forgetful__discover_forgetful_tools, mcp__forgetful__how_to_use_forgetful_tool, mcp__forgetful__execute_forgetful_tool, Bash(forgetful:*).

Does Forgetful Remember access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Forgetful Remember safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Forgetful Remember use?

Forgetful Remember is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Forgetful Remember use?

About 1.3k tokens (SKILL.md is roughly 5.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Forgetful Remember?

Skills that share tags, products or a category with Forgetful Remember: MemPalace Setup and Operation (MemPalace/mempalace, 59k stars), Qmd (breferrari/obsidian-mind, 4.9k stars), Context Mode Search (mksglu/context-mode, 26k stars) and remindb Memory Writer (radimsem/remindb, 129 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Forgetful Remember?

ScottRBK (a GitHub user) maintains it in ScottRBK/forgetful, which has 301 GitHub stars. The repository holds 10 skills in this directory. The repository was last updated on October 7, 2026.

Source: ScottRBK/forgetful on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.