Generate hierarchical codemaps and change-aware state files for unfamiliar repositories.
npx skills add https://github.com/voiddreamz/dotfiles --skill codemap-voiddreamz
Please help me install this Agent Skill. Skill: codemap Source: https://github.com/voiddreamz/dotfiles/tree/main/.config/opencode/skills/codemap Command: npx skills add https://github.com/voiddreamz/dotfiles --skill codemap-voiddreamz
.slim/codemap.json state plus empty codemap.md templates in every relevant folder. - Incremental Change Detection: Compares current file and folder hashes against saved state to report added, removed, and modified files, so only affected codemaps get updated. - Legacy Migration: Automatically migrates .slim/cartography.json state to the new .slim/codemap.json format. - Use Case: When starting work on a new repository, run the codemap workflow to produce a root Repository Atlas and per-directory maps, then register them in AGENTS.md so every agent session automatically loads the architecture context. ## Quick Start Ask the AI to generate a codemap for this repository so it can document the architecture and track future changes.High-intent search queries and answers about installing and using this skill.
Run codemap.mjs init with a root path and glob patterns, for example node codemap.mjs init --root ./ --include "src/**/*.ts" --exclude "node_modules/**". This creates .slim/codemap.json state and empty codemap.md templates in each folder.
Run codemap.mjs changes --root ./ to compare current file hashes against saved state. It lists added, removed, and modified files plus the affected folders, so you only update the codemaps that changed.
Yes, the script loads .gitignore patterns automatically and applies them alongside user-supplied exclude globs. Tests, docs, build output, and dependencies like node_modules are excluded by convention, with an --exception flag for overrides.
The script automatically migrates .slim/cartography.json to .slim/codemap.json on the next run. The migration renames the file in place and preserves all existing metadata and hashes.
Avoid running it on repositories you already understand, since it is an expensive operation intended for unfamiliar codebases. It is designed for explicit documentation or initial mapping requests, not routine edits.
arbiterForgeIsolate untrusted repositories in ephemeral Docker sandboxes for inspection and execution.
thistleknotGenerates hierarchical codemap directories from user-defined file selection rules.
alangebRun pyscan, pyanalyze, ruff, and black to generate a unified markdown report.
Varnan-TechGenerate README.md and API reference docs from a codebase knowledge graph.