symbol-lookup
Lookup symbols, addresses, units, and match metadata in crashwoc-decomp. Use when Codex needs to map a function or global to config/GCBE7D/symbols.txt, split ownership, build/GCBE7D/report.json, or fallback DWARF lines.
Best use case
symbol-lookup is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
Lookup symbols, addresses, units, and match metadata in crashwoc-decomp. Use when Codex needs to map a function or global to config/GCBE7D/symbols.txt, split ownership, build/GCBE7D/report.json, or fallback DWARF lines.
Teams using symbol-lookup should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/symbol-lookup/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How symbol-lookup Compares
| Feature / Agent | symbol-lookup | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
Lookup symbols, addresses, units, and match metadata in crashwoc-decomp. Use when Codex needs to map a function or global to config/GCBE7D/symbols.txt, split ownership, build/GCBE7D/report.json, or fallback DWARF lines.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
SKILL.md Source
# Symbol Lookup ## Primary Commands Start with the repo-local helpers: - `python tools/ai_lookup_symbol.py <name-or-address>` - `python tools/ai_context.py <name-or-address>` - `python tools/ai_lookup_unit.py <unit-or-path>` when the query is really a source file or unit Examples: - `python tools/ai_lookup_symbol.py FindAIType` - `python tools/ai_lookup_symbol.py 0x800032A0` - `python tools/ai_context.py FindAIType` ## Source Priority Use the lookup sources in this order: 1. `config/GCBE7D/symbols.txt` for validated names and addresses 2. `build/GCBE7D/report.json` for owning source paths, progress categories, and fuzzy-match data 3. `build/GCBE7D/asm/<unit>.s` when you need exact function control flow, rodata strings, or float constants from the extracted retail assembly 4. `config/GCBE7D/splits.txt` to resolve the owning unit from an address range 5. `src/dump_alphaNGCport_DWARF.txt` for fallback hints only Do not promote DWARF hints into validated facts without checking the rest of the repo state. ## Working Pattern - If you have a symbol or address, use `ai_lookup_symbol.py` first. - If you need the source path, object target, context target, and nearby functions, use `ai_context.py`. - If the task starts from a file or unit and you need the remaining-function backlog, use `ai_match_plan.py`. - If helper output and source context are not enough, inspect `build/GCBE7D/asm/<unit>.s` for the exact body and nearby rodata labels before falling back to DWARF. - If the lookup returns multiple unit candidates because of duplicate basenames, switch to the normalized unit name printed by the helper, for example `ai_1.c`. ## References - Read [references/data-sources.md](references/data-sources.md) for the important files, special cases, and examples.
Related Skills
task-pack
Generate and run provider-neutral decompilation task packs in crashwoc-decomp. Use when an agent should turn a unit, function, or decomp.me bundle into a self-contained task pack and run it against any backend (print, copilot, codex, claude, aider, or gemini).
split-maintenance
Maintain config/GCBE7D/splits.txt and its generated companions. Use when Codex needs to add or replace unit ranges, import split data from the backup file, seed split ownership, or reason about normalized unit names like ai_1.c and GBA_1.c.
project-onboarding
Onboard Codex to crashwoc-decomp. Use when working in this repository and Codex needs the project layout, build and verification commands, generated-file rules, helper tooling, or the standard workflow for Crash Bandicoot: The Wrath of Cortex GameCube decompilation.
match-workflow
Drive symbol-to-verification matching work in crashwoc-decomp. Use when Codex needs to take a symbol or unit from lookup through context gathering, narrow local builds, and final regression checks.
ghidra-workflow
Query the local Crash WOC Ghidra project through analyzeHeadless.bat for function lookup, decompilation, disassembly, and datatype inspection.
build-triage
Diagnose build failures, progress regressions, and single-object compile problems in crashwoc-decomp. Use when Codex needs to narrow a failing target, inspect report data, or summarize changes from ninja changes.
agent-orchestration
Orchestrate one Crash WOC unit or one function with Copilot using the repo-local helper scripts, prompt entry points, and a one-writer-at-a-time workflow.
decomp-match
Autonomous matching-decompilation workflow for Crash WOC GameCube units. Use when the agent needs to decomp-match functions in a C source file.
knowledge-lookup
Answer espresso knowledge questions from the authoritative knowledge files. Use when the user asks about: temperature, pressure, ratios, grind settings, freshness, extraction theory, puck prep, channeling, baskets, decaf, blends, milk steaming, drink specs, profiles, shot styles, or any espresso concept. Routes to the correct knowledge file and answers from its content rather than from memory or training data.
doc-lookup
Locate and retrieve specific documentation sections from DiPeO's docs/ by heading anchors or keywords. Returns minimal, targeted excerpts instead of full files. Use when you need precise documentation context without loading entire guides.
research-lookup
Look up current research information using Perplexity Sonar Pro Search or Sonar Reasoning Pro models through OpenRouter. Automatically selects the best model based on query complexity. Search academic papers, recent studies, technical documentation, and general research information with citations.
twitter-profile-lookup
Look up Twitter/X profiles - get bio, followers, tweets, and engagement