skills.rest
scawful
scawfulCOMMUNITY
Explore all skills by this author →
Website𝕏@scawfulGitHub

alttp-disasm-labels

Map ALTTP ROM addresses to labels using USDASM and JPDisasm sources.

Updated Dec 30, 2025
Search Tags:#symbols#labels#lookup#disassembly#alttp#usdasm#jpdasm
One-click install
npx skills add https://github.com/scawful/afs_scawful --skill alttp-disasm-labels
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: alttp-disasm-labels
Source: https://github.com/scawful/afs_scawful/tree/main/skills/alttp-disasm-labels
Command: npx skills add https://github.com/scawful/afs_scawful --skill alttp-disasm-labels

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Resolve addresses and symbols across ALTTP disassembly sources (usdasm/jpdasm) so runtime traces and bug reports map to the correct routines and data.

Core Features & Use Cases

  • Symbol -> code context: Hyrule Historian lookup, then search raw disassembly in usdasm/jpdasm for corresponding labels, improving traceability.
  • Address -> symbol mapping: Cross-reference ROM addresses to function labels using label indexes and disassembly roots to resolve runtime events.
  • Use Case: When debugging a crash log mentioning a ROM address, quickly locate the associated routine and data.

Quick Start

Query Hyrule Historian for a symbol, then confirm its presence in usdasm/jpdasm to map a ROM address to a label.

Frequently Asked Questions about alttp-disasm-labels

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I map ALTTP ROM addresses to function labels in a disassembly?▼

To map ALTTP ROM addresses to function labels, cross-reference the addresses against label indexes and disassembly roots from USDASM or JPDisasm sources to resolve runtime events into routines.

How do I find ALTTP disassembly labels when debugging a crash log?▼

Find ALTTP disassembly labels for crash logs by querying Hyrule Historian for a symbol, then searching the raw USDASM or JPDisasm output to map the ROM address to its associated routine and data.

Do I need USDASM and JPDisasm sources to look up ALTTP symbols?▼

Yes, resolving ALTTP symbols requires access to USDASM and JPDisasm sources, local label indexes, and frontmatter-driven guidance to correctly resolve context and refresh indexes as needed.

What is the best way to trace a runtime event to an ALTTP ROM routine?▼

The best way to trace a runtime event to an ALTTP ROM routine is using address-to-symbol mapping via label reference files and disassembly roots, which links runtime traces directly to the correct routines and data.

Can I use z3dk label indexes to resolve ALTTP bug reports?▼

Yes, you can resolve ALTTP bug reports by applying z3dk label indexes and disassembly sources to map the mentioned ROM addresses to the correct routines and data for improved traceability.

Related Skills

Explore More Software Engineering Skills→
OpenGGFOpenGGF
6

s3k-disasm-guide

Locate and interpret Sonic 3 & Knuckles disassembly assets and ROM offsets.

Official
Advanced
open-foxopen-fox
54

issue-analyzer

Analyze crash stacks and logs to produce root-cause reports with fix recommendations.

Community
Advanced
bianhaifeng789-huebianhaifeng789-hue

mteb-leaderboard

Retrieve and validate embedding model rankings from MTEB and HuggingFace leaderboards.

Community
Intermediate
OpenGGFOpenGGF
6

s2disasm-guide

Map Sonic 2 disassembly labels, file locations, and ROM offsets.

Official
Intermediate