Agent skill

Forgetful Procedures

by ScottRBK in ScottRBK/forgetful

Store and find procedural knowledge — reusable step-by-step how-tos — in Forgetful's skill store.

MITAuto-check passedAgent Workflows

Install Forgetful Procedures

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

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

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

At a glance

Store and find procedural knowledge — reusable step-by-step how-tos — in Forgetful's skill store.

  • Works in 5 steps: Apply the litmus → Search before create → Create with the description carrying the… → …
  • A workflow worth repeating gets worked out
  • SKILL.md covers Invoking operations, Step 1 — Apply the litmus, Step 2 — Search before create and Step 3 — Create with the…, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Forgetful Procedures is an agent skill from ScottRBK/forgetful. Store and find procedural knowledge — reusable step-by-step how-tos — in Forgetful's skill store. Use when a workflow worth repeating gets worked out, when the user asks how something is done here, or when importing or exporting SKILL.md files. Litmus: a procedure someone follows is a skill; a fact someone recalls is a memory.

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

It sits in Agent Workflows, covering Skill authoring. It works with Model Context Protocol. The repository describes itself as: Opensource Memory for Agents. The licence is MIT.

When your agent uses it

  • A workflow worth repeating gets worked out
  • The user asks how something is done here
  • Exporting SKILL.md files

Example prompts

  • “/forgetful-procedures”

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

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

  1. Apply the litmus
  2. Search before create
  3. Create with the description carrying the weight
  4. Import / export SKILL.md
  5. Link the supporting material

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

    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 Procedures loads about 878 tokens when it runs. Until then it costs about 87 tokens; SKILL.md has 378 words of instructions outside code blocks.

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

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). 378 words, ~878 tokens.

Download SKILL.mdSave it as .claude/skills/forgetful-procedures/SKILL.md (or your agent's skills folder).
name
forgetful-procedures
description
Store and find procedural knowledge — reusable step-by-step how-tos — in Forgetful's skill store. Use when a workflow worth repeating gets worked out, when the user asks how something is done here, or when importing or exporting SKILL.md files. Litmus: a procedure someone follows is a skill; a fact someone recalls is a memory.
allowed-tools
mcp__forgetful__discover_forgetful_tools, mcp__forgetful__how_to_use_forgetful_tool, mcp__forgetful__execute_forgetful_tool, Bash(forgetful:*)
license
MIT
tags
skills, procedures, how-to, skill-store

Storing and finding procedures

Forgetful's skill store is procedural memory: how-tos that agents retrieve by capability and follow. All skill operations run through the standard invocation surface below, the same as every other domain.

Invoking operations

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

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

Step 1 — Apply the litmus

"How to review pull requests in this project" is a skill; "we use conventional commits" is a memory (forgetful-remember). A procedure has steps someone follows in order; a fact is recalled and applied.

Done when: the content is confirmed procedural.

Step 2 — Search before create

search_skills for the capability first — search is semantic over skill descriptions, so query by what the procedure achieves ("deploy the API", "rotate credentials"), not its exact name. An existing skill that covers it gets updated (update_skill) rather than duplicated; names are unique.

Done when: create vs update is an informed decision.

Step 3 — Create with the description carrying the weight

The description is the only embedded field — content (up to 100KB) is stored but never searched semantically. Write the description as the retrieval surface: what the procedure achieves, when to reach for it, capability keywords. Then create_skill with kebab-case name, the full markdown procedure as content, tags, and importance.

Done when: the skill exists and a capability-phrased search_skills finds it.

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

Step 4 — Import / export SKILL.md

import_skill ingests a SKILL.md string: YAML frontmatter needs name and description; license, compatibility, tags, metadata, and allowed-tools (hyphenated on disk, mapped to allowed_tools internally) are honoured. The body after the frontmatter becomes the content. export_skill re-emits the SKILL.md, round-trip faithful — tags included.

Done when: imported skills search well (check the description survived intact) and exports open cleanly in the target platform.

Procedures rarely stand alone: link_skill_to_memory for the decisions behind the procedure, link_skill_to_document for long-form background, link_skill_to_code_artifact for the code it operates, link_skill_to_file for bundled assets. get_skill_links shows everything attached — it is the reverse lookup, returning linked memory, file, code artifact, and document IDs.

Done when: following the procedure never requires hunting for its supporting material.

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

Open the folder on GitHubat commit 7afcbf1

Compare with similar skills

Forgetful Procedures 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 Procedures compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Forgetful Procedures this skillScottRBK/forgetful301—~878Automated safety check: PassMIT
Skill Seekers Builderyusufkaraaslan/Skill_Seekers15k—~760Automated safety check: PassMIT
Skill Authoringuvwt/agentdock1.2k1 repos~1.5kAutomated safety check: NotesApache-2.0
Mistral Vibe Plugin Creatormistralai/mistral-vibe5.1k—~3.1kAutomated safety check: PassApache-2.0
Scheduler Skill Creatoragenvoy/Agenvoy564—~3kAutomated safety check: PassAGPL-3.0
Workflow Schema Tuningbreaking-brake/cc-wf-studio5.4k—~1.3kAutomated safety check: PassCustom licence

Similar skills

  • Skill Seekers Builder

    yusufkaraaslan/Skill_Seekers

    Detects the type of a knowledge source and uses the Skill Seekers MCP tools to turn docs, repos, PDFs or videos into packaged AI skills.

    15k GitHub stars~760 tokensUpdated 8 days ago
    Agent WorkflowsAuto-check passed
  • Skill Authoring

    uvwt/agentdock

    创建、设计、修改、重构和验证 AgentDock Skill 时使用;负责 Agent Skills 兼容的 SKILL.md、可移植核心、引用、辅助脚本、测试、安全边界和本地真实验证。

    1.2k GitHub starsUsed in 1 repo~1.5k tokens
    Agent WorkflowsAuto-check: notes
  • Mistral Vibe Plugin Creator

    mistralai/mistral-vibe

    Official

    Shows how to build a Vibe plugin package in the Agent Plugins 1.0 format, with a plugin.json manifest and optional skills, MCP servers, hooks and other components.

    5.1k GitHub stars~3.1k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • 建立並排程定時觸發的 skill。所有新增定時/週期任務、提醒、排程通知的請求必須走此 skill,禁止直接呼叫 schedules(mode=write)(那是 skill 已存在時的時間綁定工具,不該作為新建排程的入口)。

    564 GitHub stars~3k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Workflow Schema Tuning

    breaking-brake/cc-wf-studio

    Guides edits to cc-wf-studio's workflow schema so AI agents generate better workflows, treating schema text as prompt engineering rather than validation.

    5.4k GitHub stars~1.3k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Skill Creator

    agenvoy/Agenvoy

    Create, edit, improve, or audit AgentSkills. An agent skill from agenvoy/Agenvoy.

    564 GitHub stars~3k tokensUpdated yesterday
    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 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

Categories

Questions about Forgetful Procedures

What does Forgetful Procedures do?

Store and find procedural knowledge — reusable step-by-step how-tos — in Forgetful's skill store. Forgetful Procedures is an agent skill from ScottRBK/forgetful. Store and find procedural knowledge — reusable step-by-step how-tos — in Forgetful's skill store.

When should I use Forgetful Procedures?

Forgetful Procedures fits situations like: A workflow worth repeating gets worked out; the user asks how something is done here; exporting SKILL.md files.

How do I install Forgetful Procedures in Claude Code?

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

How do I install Forgetful Procedures in Codex?

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

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

What does Forgetful Procedures need to run?

SKILL.md names no scripts, command-line tools or credentials: Forgetful Procedures 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 Procedures 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 Procedures 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 Procedures use?

Forgetful Procedures 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 Procedures use?

About 878 tokens (SKILL.md is roughly 3.5k 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 Procedures?

Skills that share tags, products or a category with Forgetful Procedures: Skill Seekers Builder (yusufkaraaslan/Skill_Seekers, 15k stars), Skill Authoring (uvwt/agentdock, 1.2k stars), Mistral Vibe Plugin Creator (mistralai/mistral-vibe, 5.1k stars) and Scheduler Skill Creator (agenvoy/Agenvoy, 564 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Forgetful Procedures?

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.