experimental/codebase-explorer/SKILL.md
Explore a codebase to gather context for coding tasks. Preserves context window and offloads work to cheaper models.
npx skillsauth add memgrafter/skills-flatagents codebase-explorerInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Use this skill to gather codebase context before coding tasks. A staff architect agent explores using tree, ripgrep, and file reading, extracting imports, signatures, and code segments.
$HOME/.agents/skills/codebase-explorer/run.sh "<task>" [-d <directory>] [--token-budget N] [--max-iterations N]
# Explore for test writing
./run.sh "Write tests for the UserService class"
# Explore specific directory
./run.sh "Understand the authentication flow" -d src/auth
# With custom budget
./run.sh "Find all API endpoints" --token-budget 20000 --max-iterations 5
Returns structured context:
summary: narrative overview of the codebasefrozen_imports: relevant import statementsfrozen_signatures: function/class signaturesfrozen_segments: code blocks with file pathstree_outputs: directory structurefile_contents: full files that were readdevelopment
Deterministically fixes broken OpenAI Deep Research markdown citations without using an LLM: creates a .bkp backup, rewrites citation markers, rebuilds references, and runs strict regex validation.
tools
Use this as the default toolset for coding sessions when you want faster navigation, search, file inspection, and git workflow execution with lower command overhead: tools: - fzf - ripgrep - bat - delta - lazygit - starship - zoxide - eza - atuin - yazi
development
Turn a URL into a durable knowledge artifact: searchable markdown summary + local raw text archive, so you can recall it later without revisiting the web.
development
Run shell commands and analyze output with validated summaries. Use for build logs, test output, or any command with substantial output. Protects context by returning concise summaries with grep-validated citations.