Agent skill

Forgetful Context Gather

by ScottRBK in ScottRBK/forgetful

Gather deep context before planning or implementing — one pass that turns a task description into a cited context pack: relevant decisions, patterns, constraints, code pointers, procedures, and…

MITAuto-check passed

Install Forgetful Context Gather

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

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

GitHub CLI
$ gh skill install ScottRBK/forgetful forgetful-context-gather --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-context-gather .claude/skills/forgetful-context-gather && 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-context-gather
GitHub stars
301
Token cost
~1k tokens
SKILL.md length
495 words
Files
1
Skills in repo
10
Repo updated
First seen
Licence
MIT

At a glance

Gather deep context before planning or implementing — one pass that turns a task description into a cited context pack: relevant decisions, patterns, constraints, code pointers, procedures, and…

  • Works in 6 steps: Derive the query angles → Recall per angle → Explore around the strongest hits → …
  • SKILL.md covers Invoking operations, Step 1 — Derive the query angles, Step 2 — Recall per angle and Step 3 — Explore around the…, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Forgetful Context Gather is an agent skill from ScottRBK/forgetful. Gather deep context before planning or implementing — one pass that turns a task description into a cited context pack: relevant decisions, patterns, constraints, code pointers, procedures, and explicit gaps. Runs recall from several angles, explores the graph around the strongest hits, and opens the linked material.

Its SKILL.md is about 1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It works with Model Context Protocol. The repository describes itself as: Opensource Memory for Agents. The licence is MIT.

Example prompts

  • “/forgetful-context-gather”

Requirements

  • 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. Derive the query angles
  2. Recall per angle
  3. Explore around the strongest hits
  4. Open the linked material
  5. Sweep for unlinked material
  6. Synthesize the pack

What it can do on your machine

Read from SKILL.md and the folder at commit ff45893. 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

    No scripts in the folder and no shell commands in SKILL.md.

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

  • Network

    No URLs in SKILL.md.

    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 Context Gather loads about 1k tokens when it runs. Until then it costs about 86 tokens; SKILL.md has 495 words of instructions outside code blocks.

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

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 ff45893, republished under its MIT licence (© ScottRBK). 495 words, ~1,030 tokens.

Download SKILL.mdSave it as .claude/skills/forgetful-context-gather/SKILL.md (or your agent's skills folder).
name
forgetful-context-gather
description
Gather deep context before planning or implementing — one pass that turns a task description into a cited context pack: relevant decisions, patterns, constraints, code pointers, procedures, and explicit gaps. Runs recall from several angles, explores the graph around the strongest hits, and opens the linked material.
allowed-tools
mcp__forgetful__discover_forgetful_tools, mcp__forgetful__how_to_use_forgetful_tool, mcp__forgetful__execute_forgetful_tool, Bash(forgetful:*)
license
MIT
disable-model-invocation
true
tags
context, retrieval, workflow, pre-work

Gathering context before work

A single query answers a question; a context gather prepares a task. The output is a pack the work can lean on, with every claim cited by memory ID and every dry angle stated — silence is never ambiguous.

Invoking operations

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

  • MCP: execute_forgetful_tool(tool_name="query_memory", arguments={...})
  • CLI: forgetful call query_memory --args '{"query": "..."}' --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.

Delegating this workflow to a subagent: hand it the CLI flavor — Bash travels into subagents, MCP tool access does not. Run MCP-flavored gathers in the main conversation.

Step 1 — Derive the query angles

From the task description, write 3–5 distinct angles: the feature area, the technology or library, exact error text or identifiers, the architectural layer, adjacent domains that share patterns. One angle is a spot-check; several are coverage.

Done when: the angles are listed before any query runs.

Step 2 — Recall per angle

query_memory per angle — query and query_context are both required, and query_context should carry the task's intent (per forgetful-recall: reads cross-project by default, identifiers verbatim, truncated handled). Skills referenced by name in this skill resolve via search_skills → export_skill when not already available. Track which angles hit and which came up dry.

Done when: every angle has run and its outcome is recorded.

Step 3 — Explore around the strongest hits

Where hits reference entities or cluster into a topic, walk the graph (per forgetful-explore, medium depth): expand the memories, discover the entities, harvest what is attached to them.

Done when: the strongest hits have their neighbourhood mapped, not just their own text.

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

Step 4 — Open the linked material

Hits point outward — follow the pointers: get_document for linked documents, get_code_artifact for reusable code, search_skills + get_skill for procedures that already do the task, get_skill_links for what those procedures bundle.

Done when: load-bearing linked material is read, not just listed.

Step 5 — Sweep for unlinked material

Link-following only surfaces what a hit already points to — a document or code artifact that no surfaced memory links to stays invisible to that flow. Close the gap: list_documents and list_code_artifacts, scoped with project_id when the task is project-bound, then scan titles for relevance. search_skills already searches skills directly, so no separate sweep is needed there.

Done when: documents and code artifacts have been swept by title, not just reached by link.

Step 6 — Synthesize the pack

Assemble, in order of usefulness to the task:

  • Decisions that constrain the work (cited by memory ID)
  • Patterns and preferences that shape how it should be done
  • Constraints — things ruled out, with the reason
  • Code pointers — artifacts and source references worth opening
  • Procedures — stored skills that cover part of the task
  • Gaps — every angle that came up dry, stated as "no existing knowledge about X"

Done when: the pack cites its sources, states its gaps, and the task could start from it without re-querying.

© 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-context-gather of ScottRBK/forgetful.

Open the folder on GitHubat commit ff45893

Compare with similar skills

Forgetful Context Gather 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 Context Gather compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Forgetful Context Gather this skillScottRBK/forgetful301—~1kAutomated safety check: PassMIT
MCP Server Builderanthropics/skills180k63 repos~2.3kAutomated safety check: PassApache-2.0
MCP Server BuildershareAI-lab/learn-claude-code78k5 repos~1.2kAutomated safety check: PassMIT
MCP Integration for Pluginsanthropics/claude-plugins-official38k11 repos~3.1kAutomated safety check: PassApache-2.0
Figma use_figma Plugin API Ruleswarpdotdev/warp65k4 repos~4.4kAutomated safety check: PassAGPL-3.0
Stitch to Remotion Walkthrough Videosgoogle-labs-code/stitch-skills8.4k6 repos~3.2kAutomated safety check: NotesApache-2.0

Similar skills

  • MCP Server Builder

    anthropics/skills

    Official

    Guides the design and implementation of Model Context Protocol servers in TypeScript or Python, from tool naming and error messages to evaluation.

    180k GitHub starsUsed in 63 repos~2.3k tokens
    Agent WorkflowsAuto-check passed
  • MCP Server Builder

    shareAI-lab/learn-claude-code

    Walks through building MCP servers in Python or TypeScript that expose tools, resources and prompts to Claude, with templates, registration and testing.

    78k GitHub starsUsed in 5 repos~1.2k tokens
    Agent WorkflowsAuto-check passed
  • MCP Integration for Plugins

    anthropics/claude-plugins-official

    Official

    Explains how to bundle Model Context Protocol servers in a Claude Code plugin, covering config files, stdio, SSE, HTTP and WebSocket server types, and authentication.

    38k GitHub starsUsed in 11 repos~3.1k tokens
    Agent WorkflowsAuto-check passed
  • Required groundwork before any use_figma call: the rules and reference files for running JavaScript in a Figma file through the Plugin API without common failures.

    65k GitHub starsUsed in 4 repos~4.4k tokens
    Frontend & DesignAuto-check passed
  • Stitch to Remotion Walkthrough Videos

    google-labs-code/stitch-skills

    Official

    Builds walkthrough videos from Stitch design projects using Remotion, with transitions, zoom effects and text overlays on each screen.

    8.4k GitHub starsUsed in 6 repos~3.2k tokens
    Media & CreativeAuto-check: notes
  • MCP Development

    coollabsio/coolify

    A skill your agent uses for Laravel MCP development. An agent skill from coollabsio/coolify.

    63k GitHub starsUsed in 1 repo~949 tokens
    Frontend & DesignAuto-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 Remember

    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.

    301 GitHub stars~1.3k tokensUpdated yesterday
    Auto-check passed
  • 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

Questions about Forgetful Context Gather

What does Forgetful Context Gather do?

Gather deep context before planning or implementing — one pass that turns a task description into a cited context pack: relevant decisions, patterns, constraints, code pointers, procedures, and…. Forgetful Context Gather is an agent skill from ScottRBK/forgetful. Gather deep context before planning or implementing — one pass that turns a task description into a cited context pack: relevant decisions, patterns, constraints, code pointers, procedures, and explicit gaps.

How do I install Forgetful Context Gather in Claude Code?

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

How do I install Forgetful Context Gather in Codex?

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

Can I use Forgetful Context Gather 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-context-gather -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-context-gather, .gemini/skills/forgetful-context-gather, .github/skills/forgetful-context-gather and .opencode/skills/forgetful-context-gather in your project.

What does Forgetful Context Gather need to run?

SKILL.md names no scripts, command-line tools or credentials: Forgetful Context Gather is instructions for the agent only. 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 Context Gather access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Forgetful Context Gather 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 Context Gather use?

Forgetful Context Gather 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 Context Gather use?

About 1k tokens (SKILL.md is roughly 4.1k 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 Context Gather?

Skills that share tags, products or a category with Forgetful Context Gather: MCP Server Builder (anthropics/skills, 180k stars), MCP Server Builder (shareAI-lab/learn-claude-code, 78k stars), MCP Integration for Plugins (anthropics/claude-plugins-official, 38k stars) and Figma use_figma Plugin API Rules (warpdotdev/warp, 65k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Forgetful Context Gather?

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 8, 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.