Agent skill

Memories

by mweinbach in mweinbach/agent-coworker

A skill your agent uses when the user asks to view, list, inspect, add, create, edit, correct, update, or manage long-term memories for the current chat or workspace.

Custom licenceAuto-check passedAgent Workflows

Install Memories

skills CLI
$ npx skills add mweinbach/agent-coworker --skill memories -a claude-code

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

GitHub CLI
$ gh skill install mweinbach/agent-coworker memories --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/mweinbach/agent-coworker.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/memories .claude/skills/memories && 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
memories
GitHub stars
156
Token cost
~547 tokens
SKILL.md length
288 words
Files
2
Skills in repo
8
Repo updated
First seen
Licence
Custom licence

At a glance

A skill your agent uses when the user asks to view, list, inspect, add, create, edit, correct, update, or manage long-term memories for the current chat or workspace.

  • Works in 6 steps: Start with manageMemory action list to… → Use manageMemory action read before… → Prefer edit when a relevant memory… → …
  • The user asks to view
  • SKILL.md covers Workflow and Boundaries
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Memories is an agent skill from mweinbach/agent-coworker. Use when the user asks to view, list, inspect, add, create, edit, correct, update, or manage long-term memories for the current chat or workspace.

Its SKILL.md is about 550 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `agents/openai.yaml`).

It sits in Agent Workflows, covering Agent memory. The repository describes itself as: Terminal-first coworker agent (Bun + OpenTUI).

When your agent uses it

  • The user asks to view
  • Manage long-term memories for the current chat

Example prompts

  • “/memories”

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. Start with manageMemory action list to see the active folder, readable folders, paths, and summaries.
  2. Use manageMemory action read before changing an existing memory.
  3. Prefer edit when a relevant memory already exists. Use create only for a genuinely new durable fact, preference, or project note.
  4. Keep memory bodies concise and factual. Do not store secrets, credentials, transient status, or speculative conclusions.
  5. Use memory types consistently: feedback for user preferences or corrections, project for workspace-specific implementation context, and…
  6. After any unavoidable manual memory file repair, run manageMemory action refresh_index.

What it can do on your machine

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

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    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

Memories loads about 547 tokens when it runs. Until then it costs about 39 tokens; SKILL.md has 288 words of instructions outside code blocks.

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

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

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 288 words (~547 tokens).

“Use this skill for explicit memory-management requests. The goal is to keep long-term memory accurate without touching unrelated folders or inventing duplicate entries.”

— opening of SKILL.md by mweinbach, Custom licence
name
memories

Read the full SKILL.md on GitHub

Files

SKILL.md and 1 other file in skills/memories of mweinbach/agent-coworker.

  • SKILL.md
  • agents/openai.yaml

Open the folder on GitHubat commit aab9dc6

Compare with similar skills

Memories 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.

Memories compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Memories this skillmweinbach/agent-coworker156—~547Automated safety check: PassCustom licence
Neat-Freak Knowledge CloseoutKKKKhazix/khazix-skills21k—~1.9kAutomated safety check: PassMIT
Beads Task Memorygastownhall/beads28k—~1.2kAutomated safety check: PassMIT
Reflect on Session Learningscursor/plugins10k5 repos~1.2kAutomated safety check: PassNone
MemPalace Memory SearchMemPalace/mempalace59k—~1.4kAutomated safety check: PassMIT
Compound Learning WriterEveryInc/compound-engineering-plugin25k—~2kAutomated safety check: PassMIT

Similar skills

  • Neat-Freak Knowledge Closeout

    KKKKhazix/khazix-skills

    Brings project docs, agent rule files, authorized memory and leftover workspace files back in line with what the code and runtime actually do at the end of a work session.

    21k GitHub stars~1.9k tokensUpdated 8 days ago
    Agent WorkflowsAuto-check passed
  • Beads Task Memory

    gastownhall/beads

    Tracks multi-session work with dependencies in the bd issue tracker so the agent can find ready tasks and recover its context after conversation compaction.

    28k GitHub stars~1.2k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Official

    Starts three parallel reviewer subagents over the current conversation transcript, then turns their findings into concrete edits to existing skills.

    10k GitHub starsUsed in 5 repos~1.2k tokens
    Agent WorkflowsAuto-check passed
  • MemPalace Memory Search

    MemPalace/mempalace

    Mines project files and conversation exports into a local, searchable memory palace and recalls past work by semantic search through the mempalace CLI.

    59k GitHub stars~1.4k tokensUpdated 2 days ago
    Agent WorkflowsAuto-check passed
  • Compound Learning Writer

    EveryInc/compound-engineering-plugin

    Records one solved and verified problem as a durable learning in the repository, but only when the reasoning is not already clear from the final code, tests or docs.

    25k GitHub stars~2k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Searches past Claude Code, Codex and Cursor sessions and summarizes what was worked on, tried or decided, using extraction scripts instead of reading raw logs.

    24k GitHub stars~3.1k tokensUpdated today
    Agent WorkflowsAuto-check passed

More from mweinbach/agent-coworker

All 8 skills in this repo
  • AI Elements Chat Components

    mweinbach/agent-coworker

    Adds AI Elements components such as conversations, messages, tool displays and prompt inputs to a Next.js project that uses shadcn/ui.

    156 GitHub starsUsed in 5 repos~1.8k tokens
    Auto-check passed
  • Expo Brownfield Integration

    mweinbach/agent-coworker

    Helps add Expo and React Native to an existing native iOS or Android app, and choose between a prebuilt AAR or XCFramework and a fully integrated build.

    156 GitHub starsUsed in 2 repos~900 tokens
    Auto-check: notes
  • Use Dom

    mweinbach/agent-coworker

    Use Expo DOM components to run web code in a webview on native and as-is on web.

    156 GitHub starsUsed in 5 repos~2.4k tokens
    Auto-check passed
  • Bun Runtime and Toolkit

    mweinbach/agent-coworker

    Quick reference for using Bun to run TypeScript and JavaScript, install packages, bundle code, run tests and serve HTTP, with the key files and commands.

    156 GitHub stars~2.2k tokensUpdated yesterday
    Auto-check: notes
  • Workflow

    mweinbach/agent-coworker

    Author and run a deterministic multi-agent workflow — a JavaScript script that fans out, pipelines, loops, and judges across many child agents.

    156 GitHub stars~2.6k tokensUpdated yesterday
    Auto-check passed
  • Improve Animations

    mweinbach/agent-coworker

    Audit a codebase's animation and motion, produce prioritized improvement plans, and execute selected plans when requested.

    156 GitHub stars~2.5k tokensUpdated yesterday
    Auto-check passed

Categories

Questions about Memories

What does Memories do?

A skill your agent uses when the user asks to view, list, inspect, add, create, edit, correct, update, or manage long-term memories for the current chat or workspace. Memories is an agent skill from mweinbach/agent-coworker. Use when the user asks to view, list, inspect, add, create, edit, correct, update, or manage long-term memories for the current chat or workspace.

When should I use Memories?

Memories fits situations like: the user asks to view; manage long-term memories for the current chat.

How do I install Memories in Claude Code?

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

How do I install Memories in Codex?

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

Can I use Memories 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 mweinbach/agent-coworker --skill memories -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/memories, .gemini/skills/memories, .github/skills/memories and .opencode/skills/memories in your project.

What does Memories need to run?

SKILL.md names no scripts, command-line tools or credentials: Memories is instructions for the agent only.

Does Memories 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 Memories 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 Memories use?

Memories has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Memories use?

About 547 tokens (SKILL.md is roughly 2.2k 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 Memories?

Skills that share tags, products or a category with Memories: Neat-Freak Knowledge Closeout (KKKKhazix/khazix-skills, 21k stars), Beads Task Memory (gastownhall/beads, 28k stars), Reflect on Session Learnings (cursor/plugins, 10k stars) and MemPalace Memory Search (MemPalace/mempalace, 59k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Memories?

mweinbach (a GitHub user) maintains it in mweinbach/agent-coworker, which has 156 GitHub stars. The repository holds 8 skills in this directory. The repository was last updated on October 8, 2026.

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