Agent skill

Memory Mine

by dimetron in dimetron/pi-go

Mine project files or conversations into the MemPalace memory system.

MITAuto-check passedAI & LLM Engineering

Install Memory Mine

skills CLI
$ npx skills add dimetron/pi-go --skill memory-mine -a claude-code

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

GitHub CLI
$ gh skill install dimetron/pi-go memory-mine --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/dimetron/pi-go.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.pi-go/skills/memory-mine .claude/skills/memory-mine && 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
memory-mine
GitHub stars
207
Token cost
~627 tokens
SKILL.md length
275 words
Files
1
Skills in repo
21
Repo updated
First seen
Licence
MIT

At a glance

Mine project files or conversations into the MemPalace memory system.

  • Works in 2 steps: Source mining (default): Walks the… → Conversation mining (--convos): Parses…
  • Tasks that involve Embeddings
  • SKILL.md covers When to use, What it does, Steps and Arguments, plus 2 more sections
  • Calls go

What it does

Memory Mine is an agent skill from dimetron/pi-go. Mine project files or conversations into the MemPalace memory system. Indexes source code and conversation history as searchable palace drawers with semantic embeddings and room assignment.

Its SKILL.md is about 630 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 AI & LLM Engineering, covering Embeddings. The repository describes itself as: Go implementation of AI coding agent. The licence is MIT.

When your agent uses it

  • Tasks that involve Embeddings

Example prompts

  • “/memory-mine”

Workflow steps

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

  1. Source mining (default): Walks the directory tree, chunks source files (1500 chars, 200 overlap), assigns rooms via mempalace.yaml…
  2. Conversation mining (--convos): Parses JSONL (pi-go or Claude Code format) and plaintext conversations, pairs user+assistant turns, and…

What it can do on your machine

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

    Shell commands in SKILL.md call:

    • go

    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

Memory Mine loads about 627 tokens when it runs. Until then it costs about 50 tokens; SKILL.md has 275 words of instructions outside code blocks.

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

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 dimetron/pi-go at commit 24d1f2b, republished under its MIT licence (© dimetron). 275 words, ~627 tokens.

Download SKILL.mdSave it as .claude/skills/memory-mine/SKILL.md (or your agent's skills folder).
name
memory-mine
description
Mine project files or conversations into the MemPalace memory system. Indexes source code and conversation history as searchable palace drawers with semantic embeddings and room assignment.
user_invocable
true
metadata.author
dimetron
metadata.version
1.0

When to use

Use this skill when the user wants to:

  • Index/mine project source files into the palace memory
  • Mine conversation history (JSONL, text) into the palace
  • Rebuild or refresh the palace knowledge base from disk
  • Bootstrap memory for a new project

What it does

Runs pi memory mine to walk a directory and ingest files as palace drawers:

  1. Source mining (default): Walks the directory tree, chunks source files (1500 chars, 200 overlap), assigns rooms via mempalace.yaml patterns or directory structure, generates embeddings, deduplicates (cosine >= 0.9), and stores as drawers.

  2. Conversation mining (--convos): Parses JSONL (pi-go or Claude Code format) and plaintext conversations, pairs user+assistant turns, and stores as drawers with importance=4.

Steps

  1. Check if palace.db exists (run pi memory init . if not)
  2. Check if the embedding model is downloaded (run pi memory model download if not)
  3. Run the mine command:
bash
# Mine source files from current directory
pi memory mine .

# Mine source files with explicit wing name
pi memory mine . --wing my-project

# Mine conversation files
pi memory mine ./conversations --convos
  1. Show the results (processed, added, skipped duplicates, errors)
  2. Optionally run pi memory status to confirm the updated state

Arguments

The user can pass arguments after /memory-mine:

  • A directory path (default: . current directory)
  • --wing <name> to override the wing name
  • --convos to mine conversations instead of source files

Examples:

  • /memory-mine — mine current directory
  • /memory-mine ./src — mine the src directory
  • /memory-mine ./chats --convos — mine conversation files

Prerequisites

  • pi binary must be built and available (go build -o pi ./cmd/pi)
  • Palace DB must be initialized (pi memory init .)
  • For semantic search, embedding model must be downloaded (pi memory model download)

Notes

  • Respects .gitignore patterns
  • Skips hidden dirs, node_modules, vendor, .git, build, target
  • Skips files > 512 KB
  • Uses mempalace.yaml for room assignment if present
  • Duplicates (cosine similarity >= 0.9) are automatically skipped

© dimetron, 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 .pi-go/skills/memory-mine of dimetron/pi-go.

Open the folder on GitHubat commit 24d1f2b

Compare with similar skills

Memory Mine 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.

Memory Mine compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Memory Mine this skilldimetron/pi-go207—~627Automated safety check: PassMIT
Chroma Vector DatabaseOrchestra-Research/AI-Research-SKILLs13k8 repos~2.3kAutomated safety check: PassMIT
CLIP Image-Text MatchingOrchestra-Research/AI-Research-SKILLs13k8 repos~1.7kAutomated safety check: PassMIT
SageMaker Serving Image Selectionhuggingface/skills11k1 repos~4.6kAutomated safety check: PassApache-2.0
Codebase Managementgiancarloerra/SocratiCode3.3k1 repos~1.8kAutomated safety check: PassAGPL-3.0
Sentence-Transformers Training Routerhuggingface/skills11k1 repos~2.6kAutomated safety check: PassApache-2.0

Similar skills

  • Chroma Vector Database

    Orchestra-Research/AI-Research-SKILLs

    Shows how to store documents and embeddings in Chroma, query them by similarity with metadata filters, and persist them to disk for RAG and semantic search projects.

    13k GitHub starsUsed in 8 repos~2.3k tokens
    AI & LLM EngineeringAuto-check passed
  • CLIP Image-Text Matching

    Orchestra-Research/AI-Research-SKILLs

    Explains OpenAI's CLIP model for zero-shot image classification, image-text similarity, semantic image search and content moderation, with install steps and code patterns.

    13k GitHub starsUsed in 8 repos~1.7k tokens
    AI & LLM EngineeringAuto-check passed
  • Official

    Chooses the right serving container and current image URI for deploying a Hugging Face model to a SageMaker endpoint, preferring Hugging Face images over generic ones.

    11k GitHub starsUsed in 1 repo~4.6k tokens
    AI & LLM EngineeringAuto-check passed
  • Codebase Management

    giancarloerra/SocratiCode

    Set up, index, and manage SocratiCode codebase indexing. An agent skill from giancarloerra/SocratiCode.

    3.3k GitHub starsUsed in 1 repo~1.8k tokens
    AI & LLM EngineeringAuto-check passed
  • Official

    Routes a sentence-transformers training task to the right model type and required reference docs and example scripts, covering bi-encoders, rerankers, sparse and multi-vector models.

    11k GitHub starsUsed in 1 repo~2.6k tokens
    AI & LLM EngineeringAuto-check passed
  • Mashup Mods

    rehan-remade/universal-modder

    Build cross-game mashups and total conversions, the "Minecraft inside Elden Ring" or "skateboarding in MW2" kind.

    5.3k GitHub stars~3.3k tokensUpdated today
    AI & LLM EngineeringAuto-check passed

More from dimetron/pi-go

All 21 skills in this repo
  • Vhs E2E Gif

    dimetron/pi-go

    Record a test run, a TUI session, or any terminal command as a GIF with VHS and attach it to a GitHub PR as a release-hosted asset, never a repo commit.

    207 GitHub stars~1.7k tokensUpdated 7 days ago
    Auto-check passed
  • Agents Md

    dimetron/pi-go

    Generate AGENTS.md files for Go, Rust, TypeScript, and Java projects.

    207 GitHub stars~1.7k tokensUpdated 7 days ago
    Auto-check passed
  • Bubbletea Testing

    dimetron/pi-go

    A skill your agent uses whenever writing tests for Bubble Tea (charmbracelet/bubbletea) TUI applications in Go.

    207 GitHub stars~3.6k tokensUpdated 7 days ago
    Auto-check passed
  • Memory Index

    dimetron/pi-go

    Index a folder's contents into the MemPalace semantic memory for search and retrieval.

    207 GitHub stars~1.5k tokensUpdated 7 days ago
    Auto-check passed
  • Nightly Session Watch

    dimetron/pi-go

    Nightly sweep of the last 24h of pi-go sessions — anomalous runs, loop aborts, tool error rates, token waste, real prompt-token spend, and whether the observation and palace pipelines are still…

    207 GitHub stars~1.5k tokensUpdated 7 days ago
    Auto-check passed
  • Osx Tuning

    dimetron/pi-go

    Tune macOS resource limits and sysctls for best performance with Go development, Docker/OrbStack, and Linux VMs.

    207 GitHub stars~1.6k tokensUpdated 7 days ago
    Auto-check: notes

Questions about Memory Mine

What does Memory Mine do?

Mine project files or conversations into the MemPalace memory system. Memory Mine is an agent skill from dimetron/pi-go. Mine project files or conversations into the MemPalace memory system.

When should I use Memory Mine?

Memory Mine fits situations like: tasks that involve Embeddings.

How do I install Memory Mine in Claude Code?

Run `npx skills add dimetron/pi-go --skill memory-mine -a claude-code`. Or copy the skill folder (.pi-go/skills/memory-mine in dimetron/pi-go) into .claude/skills/memory-mine in your project. Claude Code loads it when a task matches its description.

How do I install Memory Mine in Codex?

Run `npx skills add dimetron/pi-go --skill memory-mine -a codex`. Or copy the skill folder (.pi-go/skills/memory-mine in dimetron/pi-go) into .agents/skills/memory-mine in your project. Codex loads it when a task matches its description.

Can I use Memory Mine 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 dimetron/pi-go --skill memory-mine -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/memory-mine, .gemini/skills/memory-mine, .github/skills/memory-mine and .opencode/skills/memory-mine in your project.

What does Memory Mine need to run?

Going by SKILL.md and its folder, Memory Mine needs the command-line tools its instructions call (go).

Does Memory Mine 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 Memory Mine 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 Memory Mine use?

Memory Mine is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Memory Mine use?

About 627 tokens (SKILL.md is roughly 2.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 Memory Mine?

Skills that share tags, products or a category with Memory Mine: Chroma Vector Database (Orchestra-Research/AI-Research-SKILLs, 13k stars), CLIP Image-Text Matching (Orchestra-Research/AI-Research-SKILLs, 13k stars), SageMaker Serving Image Selection (huggingface/skills, 11k stars) and Codebase Management (giancarloerra/SocratiCode, 3.3k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Memory Mine?

dimetron (a GitHub user) maintains it in dimetron/pi-go, which has 207 GitHub stars. The repository holds 21 skills in this directory. The repository was last updated on October 1, 2026.

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