r2000-analyze-symbol

Analyze 6502 memory addresses and labels to identify symbol purposes.

163|9|Updated Dec 20, 2025
One-click install
npx skills add https://github.com/ricardoquesada/regenerator2000 --skill r2000-analyze-symbol
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: r2000-analyze-symbol
Source: https://github.com/ricardoquesada/regenerator2000/tree/main/.agent/skills/r2000-analyze-symbol
Command: npx skills add https://github.com/ricardoquesada/regenerator2000 --skill r2000-analyze-symbol

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps you understand the purpose of memory addresses and labels within 6502 assembly code, transforming raw addresses into meaningful variable, pointer, or hardware register names.

Core Features & Use Cases

  • Symbol Analysis: Identifies if a symbol is a hardware register, pointer, flag, counter, or state variable.
  • Contextual Understanding: Leverages platform-specific knowledge (like C64 hardware registers) and cross-reference data to infer symbol roles.
  • Use Case: When you encounter an unfamiliar address like $D020 in C64 code, this Skill can identify it as the VIC-II border color register and rename it accordingly.

Quick Start

Analyze the symbol at the current cursor position to determine its purpose.

Frequently Asked Questions about r2000-analyze-symbol

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

FAQPage Schema
How do I identify the purpose of unknown memory addresses in 6502 disassembly?

Analyze unknown 6502 memory addresses by examining their cross-references and usage patterns. The skill determines whether an address functions as a hardware register, pointer, flag, counter, or state variable, using platform context and usage heuristics to rename and comment symbols.

What does a specific address like $D020 mean in C64 assembly code?

In C64 assembly code, an address like $D020 is identified as the VIC-II border color register. The skill leverages platform-specific hardware knowledge to identify such registers and automatically renames and comments the symbols for improved code readability.

Can I automatically rename labels and add comments to 6502 assembly code?

Yes, you can automatically rename labels and add comments to 6502 assembly code. After determining a symbol's purpose by examining cross-references and platform context, the skill renames the symbol and adds explanatory comments to improve code readability.

Does this symbol analysis tool support hardware register identification for retro platforms?

Yes, symbol analysis supports hardware register identification for retro platforms. It leverages platform-specific knowledge, such as C64 hardware registers, and cross-reference data to infer the roles of symbols based on platform context and usage heuristics.

How do cross-references help with reverse engineering 6502 code?

Cross-references help with reverse engineering 6502 code by revealing how and where a memory address or label is accessed. Examining these usage patterns allows the identification of flags, counters, pointers, and state variables to determine the symbol's purpose.