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.
Analyze codebase with parallel mapper agents to produce .planning/codebase/ documents
Install Gsd Map Codebase
$ npx skills add SpillwaveSolutions/agent-brain --skill gsd-map-codebase -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install SpillwaveSolutions/agent-brain gsd-map-codebase --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/SpillwaveSolutions/agent-brain.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.codex/skills/gsd-map-codebase .claude/skills/gsd-map-codebase && rm -rf skills-srcUse ~/.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/
Install the "gsd-map-codebase" agent skill from https://github.com/SpillwaveSolutions/agent-brain/tree/main/.codex/skills/gsd-map-codebase into .claude/skills/gsd-map-codebase/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "gsd-map-codebase", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/SpillwaveSolutions/agent-brain/tree/main/.codex/skills/gsd-map-codebaseType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add SpillwaveSolutions/agent-brain --skill gsd-map-codebase -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install SpillwaveSolutions/agent-brain gsd-map-codebase --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/SpillwaveSolutions/agent-brain.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.codex/skills/gsd-map-codebase .agents/skills/gsd-map-codebase && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "gsd-map-codebase" agent skill from https://github.com/SpillwaveSolutions/agent-brain/tree/main/.codex/skills/gsd-map-codebase into .agents/skills/gsd-map-codebase/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "gsd-map-codebase", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add SpillwaveSolutions/agent-brain --skill gsd-map-codebase -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install SpillwaveSolutions/agent-brain gsd-map-codebase --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/SpillwaveSolutions/agent-brain.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.codex/skills/gsd-map-codebase .cursor/skills/gsd-map-codebase && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "gsd-map-codebase" agent skill from https://github.com/SpillwaveSolutions/agent-brain/tree/main/.codex/skills/gsd-map-codebase into .cursor/skills/gsd-map-codebase/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "gsd-map-codebase", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/SpillwaveSolutions/agent-brain.git --path .codex/skills/gsd-map-codebase--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add SpillwaveSolutions/agent-brain --skill gsd-map-codebase -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install SpillwaveSolutions/agent-brain gsd-map-codebase --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/SpillwaveSolutions/agent-brain.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.codex/skills/gsd-map-codebase .gemini/skills/gsd-map-codebase && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "gsd-map-codebase" agent skill from https://github.com/SpillwaveSolutions/agent-brain/tree/main/.codex/skills/gsd-map-codebase into .gemini/skills/gsd-map-codebase/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "gsd-map-codebase", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install SpillwaveSolutions/agent-brain gsd-map-codebaseInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add SpillwaveSolutions/agent-brain --skill gsd-map-codebase -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/SpillwaveSolutions/agent-brain.git skills-src && mkdir -p .github/skills && cp -r skills-src/.codex/skills/gsd-map-codebase .github/skills/gsd-map-codebase && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "gsd-map-codebase" agent skill from https://github.com/SpillwaveSolutions/agent-brain/tree/main/.codex/skills/gsd-map-codebase into .github/skills/gsd-map-codebase/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "gsd-map-codebase", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add SpillwaveSolutions/agent-brain --skill gsd-map-codebase -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install SpillwaveSolutions/agent-brain gsd-map-codebase --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/SpillwaveSolutions/agent-brain.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.codex/skills/gsd-map-codebase .opencode/skills/gsd-map-codebase && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "gsd-map-codebase" agent skill from https://github.com/SpillwaveSolutions/agent-brain/tree/main/.codex/skills/gsd-map-codebase into .opencode/skills/gsd-map-codebase/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "gsd-map-codebase", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
gsd-map-codebase- GitHub stars
- 120
- Used in
- 4 other repos
- Token cost
- ~1.1k tokens
- SKILL.md length
- 466 words
- Files
- 1
- Skills in repo
- 55
- Repo updated
- First seen
- Licence
- MIT
At a glance
Analyze codebase with parallel mapper agents to produce .planning/codebase/ documents
- Works in 7 steps: Check if .planning/codebase/ already… → Create .planning/codebase/ directory… → Spawn 4 parallel gsd-codebase-mapper… → …
- Agent Workflows work in your project
- SKILL.md covers A. Skill Invocation, B. AskUserQuestion →… and C. Task() → spawn_agent Mapping
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
What it does
Gsd Map Codebase is an agent skill from SpillwaveSolutions/agent-brain. Analyze codebase with parallel mapper agents to produce .planning/codebase/ documents
Its SKILL.md is about 1.1k 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. The repository describes itself as: Local-first RAG memory for AI agents: hybrid + GraphRAG search, MCP server with OAuth 2.1, plugin for Claude Code / OpenCode / Codex. The licence is MIT.
When your agent uses it
- Agent Workflows work in your project
Example prompts
- “/gsd-map-codebase”
Workflow steps
7 steps, taken from the first numbered list in SKILL.md.
- Check if .planning/codebase/ already exists (offer to refresh or skip)
- Create .planning/codebase/ directory structure
- Spawn 4 parallel gsd-codebase-mapper agents
- Wait for agents to complete, collect confirmations (NOT document contents)
- Verify all 7 documents exist with line counts
- Commit codebase map
- Offer next steps (typically: $gsd-new-project or $gsd-plan-phase)
What it can do on your machine
Read from SKILL.md and the folder at commit 8339623. 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
Gsd Map Codebase loads about 1.1k tokens when it runs. Until then it costs about 26 tokens; SKILL.md has 466 words of instructions outside code blocks.
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 SpillwaveSolutions/agent-brain at commit 8339623, republished under its MIT licence (© SpillwaveSolutions). 466 words, ~1,096 tokens.
Download SKILL.mdSave it as
.claude/skills/gsd-map-codebase/SKILL.md (or your agent's skills folder).- name
- gsd-map-codebase
- description
- Analyze codebase with parallel mapper agents to produce .planning/codebase/ documents
- metadata.short-description
- Analyze codebase with parallel mapper agents to produce .planning/codebase/ documents
<codex_skill_adapter>
A. Skill Invocation
- This skill is invoked by mentioning
$gsd-map-codebase. - Treat all user text after
$gsd-map-codebaseas{{GSD_ARGS}}. - If no arguments are present, treat
{{GSD_ARGS}}as empty.
B. AskUserQuestion → request_user_input Mapping
GSD workflows use AskUserQuestion (Claude Code syntax). Translate to Codex request_user_input:
Parameter mapping:
header→headerquestion→question- Options formatted as
"Label" — description→{label: "Label", description: "description"} - Generate
idfrom header: lowercase, replace spaces with underscores
Batched calls:
AskUserQuestion([q1, q2])→ singlerequest_user_inputwith multiple entries inquestions[]
Multi-select workaround:
- Codex has no
multiSelect. Use sequential single-selects, or present a numbered freeform list asking the user to enter comma-separated numbers.
Execute mode fallback:
- When
request_user_inputis rejected (Execute mode), present a plain-text numbered list and pick a reasonable default.
C. Task() → spawn_agent Mapping
GSD workflows use Task(...) (Claude Code syntax). Translate to Codex collaboration tools:
Direct mapping:
Task(subagent_type="X", prompt="Y")→spawn_agent(agent_type="X", message="Y")Task(model="...")→ omit (Codex uses per-role config, not inline model selection)fork_context: falseby default — GSD agents load their own context via<files_to_read>blocks
Parallel fan-out:
- Spawn multiple agents → collect agent IDs →
wait(ids)for all to complete
Result parsing:
- Look for structured markers in agent output:
CHECKPOINT,PLAN COMPLETE,SUMMARY, etc. close_agent(id)after collecting results from each agent </codex_skill_adapter>
<objective>
Analyze existing codebase using parallel gsd-codebase-mapper agents to produce structured codebase documents.Each mapper agent explores a focus area and writes documents directly to .planning/codebase/. The orchestrator only receives confirmations, keeping context usage minimal.
Output: .planning/codebase/ folder with 7 structured documents about the codebase state.
</objective>
<execution_context> @/Users/richardhightower/clients/spillwave/src/agent-brain/.codex/get-shit-done/workflows/map-codebase.md </execution_context>
<context>
Focus area: {{GSD_ARGS}} (optional - if provided, tells agents to focus on specific subsystem)Load project state if exists: Check for .planning/STATE.md - loads context if project already initialized
This command can run:
Show full SKILL.md (185 more words)Show less
- Before $gsd-new-project (brownfield codebases) - creates codebase map first
- After $gsd-new-project (greenfield codebases) - updates codebase map as code evolves
- Anytime to refresh codebase understanding
</context>
<when_to_use> Use map-codebase for:
- Brownfield projects before initialization (understand existing code first)
- Refreshing codebase map after significant changes
- Onboarding to an unfamiliar codebase
- Before major refactoring (understand current state)
- When STATE.md references outdated codebase info
Skip map-codebase for:
- Greenfield projects with no code yet (nothing to map)
- Trivial codebases (<5 files) </when_to_use>
<process>
1. Check if .planning/codebase/ already exists (offer to refresh or skip)
2. Create .planning/codebase/ directory structure
3. Spawn 4 parallel gsd-codebase-mapper agents:
- Agent 1: tech focus → writes STACK.md, INTEGRATIONS.md
- Agent 2: arch focus → writes ARCHITECTURE.md, STRUCTURE.md
- Agent 3: quality focus → writes CONVENTIONS.md, TESTING.md
- Agent 4: concerns focus → writes CONCERNS.md
4. Wait for agents to complete, collect confirmations (NOT document contents)
5. Verify all 7 documents exist with line counts
6. Commit codebase map
7. Offer next steps (typically: $gsd-new-project or $gsd-plan-phase)
</process><success_criteria>
- .planning/codebase/ directory created
- All 7 codebase documents written by mapper agents
- Documents follow template structure
- Parallel agents completed without errors
- User knows next steps </success_criteria>
© SpillwaveSolutions, 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 .codex/skills/gsd-map-codebase of SpillwaveSolutions/agent-brain.
Open the folder on GitHubat commit 8339623
Used in 4 other repositories
We found 16 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 4 other GitHub owners. This page covers the copy in SpillwaveSolutions/agent-brain, which our catalogue first saw on October 7, 2026.
- open-gsd/gsd-coreskills/gsd-map-codebase
- protoconf/protoconf.kilo/skills/gsd-map-codebase.codex/skills/gsd-map-codebase+10 more
- majiayu000/claude-skill-registryskills/analysis/gsd-map-codebase-davepoon-buildwithclaudeskills/analysis/map-codebase-davepoon-buildwithclaude
- davepoon/buildwithclaudeplugins/gsd/skills/map-codebase
Compare with similar skills
Gsd Map Codebase 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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Gsd Map Codebase this skillSpillwaveSolutions/agent-brain | 120 | 4 repos | ~1.1k | Automated safety check: Pass | MIT | |
| MemPalace Memory SearchMemPalace/mempalace | 59k | — | ~1.4k | Automated safety check: Pass | MIT | |
| MemPalace Setup and OperationMemPalace/mempalace | 59k | — | ~2.2k | Automated safety check: Pass | MIT | |
| Qmdbreferrari/obsidian-mind | 4.9k | — | ~1.7k | Automated safety check: Pass | MIT | |
| Aiception Skill ExtractionNateBJones-Projects/OB1 | 4.7k | — | ~2k | Automated safety check: Notes | Custom licence | |
| Using LWC Memory and Graphssickn33/agentic-awesome-skills | 47k | 1 repos | ~2k | Automated safety check: Pass | Apache-2.0 |
Similar skills
MemPalace Setup and Operation
MemPalace/mempalace
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.
Qmd
breferrari/obsidian-mind
Search the vault using QMD semantic search. An agent skill from breferrari/obsidian-mind.
Aiception Skill Extraction
NateBJones-Projects/OB1
Pulls reusable knowledge out of work sessions and turns it into new skills, checking existing notes and skills first to avoid duplicates.
Using LWC Memory and Graphs
sickn33/agentic-awesome-skills
Keeps project decisions, research and verified results available across coding-agent sessions through LWC memory, a document Wiki graph and a CodeGraph code index.
Documentation Server
andrea9293/mcp-documentation-server
A skill your agent uses when you need to store, retrieve, search, or manage documents in a local knowledge base with semantic search and hybrid (vector + full-text) retrieval.
More from SpillwaveSolutions/agent-brain
All 55 skills in this repoGsd Complete Milestone
SpillwaveSolutions/agent-brain
Archive completed milestone and prepare for next version. An agent skill from SpillwaveSolutions/agent-brain.
Mastering Python Skill
SpillwaveSolutions/agent-brain
Modern Python coaching covering language foundations through advanced production patterns.
Gsd Debug
SpillwaveSolutions/agent-brain
Systematic debugging with persistent state across context resets
Gsd Review Backlog
SpillwaveSolutions/agent-brain
Review and promote backlog items to active milestone. An agent skill from SpillwaveSolutions/agent-brain.
Configuring Agent Brain
SpillwaveSolutions/agent-brain
Installation and configuration skill for Agent Brain document search system.
Gsd Thread
SpillwaveSolutions/agent-brain
Manage persistent context threads for cross-session work. An agent skill from SpillwaveSolutions/agent-brain.
Related
Categories
Questions about Gsd Map Codebase
What does Gsd Map Codebase do?
Analyze codebase with parallel mapper agents to produce .planning/codebase/ documents. Gsd Map Codebase is an agent skill from SpillwaveSolutions/agent-brain.
When should I use Gsd Map Codebase?
Gsd Map Codebase fits situations like: agent Workflows work in your project.
How do I install Gsd Map Codebase in Claude Code?
Run `npx skills add SpillwaveSolutions/agent-brain --skill gsd-map-codebase -a claude-code`. Or copy the skill folder (.codex/skills/gsd-map-codebase in SpillwaveSolutions/agent-brain) into .claude/skills/gsd-map-codebase in your project. Claude Code loads it when a task matches its description.
How do I install Gsd Map Codebase in Codex?
Run `npx skills add SpillwaveSolutions/agent-brain --skill gsd-map-codebase -a codex`. Or copy the skill folder (.codex/skills/gsd-map-codebase in SpillwaveSolutions/agent-brain) into .agents/skills/gsd-map-codebase in your project. Codex loads it when a task matches its description.
Can I use Gsd Map Codebase 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 SpillwaveSolutions/agent-brain --skill gsd-map-codebase -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/gsd-map-codebase, .gemini/skills/gsd-map-codebase, .github/skills/gsd-map-codebase and .opencode/skills/gsd-map-codebase in your project.
What does Gsd Map Codebase need to run?
SKILL.md names no scripts, command-line tools or credentials: Gsd Map Codebase is instructions for the agent only.
Does Gsd Map Codebase 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 Gsd Map Codebase 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 Gsd Map Codebase use?
Gsd Map Codebase 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 Gsd Map Codebase use?
About 1.1k tokens (SKILL.md is roughly 4.4k 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 Gsd Map Codebase?
Skills that share tags, products or a category with Gsd Map Codebase: MemPalace Memory Search (MemPalace/mempalace, 59k stars), MemPalace Setup and Operation (MemPalace/mempalace, 59k stars), Qmd (breferrari/obsidian-mind, 4.9k stars) and Aiception Skill Extraction (NateBJones-Projects/OB1, 4.7k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Gsd Map Codebase?
SpillwaveSolutions (a GitHub organization) maintains it in SpillwaveSolutions/agent-brain, which has 120 GitHub stars. The repository holds 55 skills in this directory. The repository was last updated on September 19, 2026.
Source: SpillwaveSolutions/agent-brain on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.