| name | atari8bit |
| description | Root router for Atari 8-bit XL/XE AI-agent skills. Load this file first, then choose the smallest matching topic file from this skill directory. |
Atari 8-bit Agentic Programming Skills
Type: Root router and taxonomy
Purpose: Route Atari XL/XE programming, reversing, and hardware questions to the smallest useful English skill file.
Use progressive disclosure:
- Read this router.
- Open exactly one or two topic files that match the task.
- Use additional topic files only when the task crosses domains.
This skill is self-contained. The topic files below are the available reference material in this repository.
1. hardware/ — Silicon Reference
hardware/cpu.md — 6502/65C02/65C816 flags, timing, undocumented opcodes, IRQ/NMI/BRK, opcode quick reference.hardware/antic.md — ANTIC DMA, display-list instruction bytes, scrolling registers, DLI timing, WSYNC, NMIEN/NMIST.hardware/gtia.md — GTIA registers, color model, GTIA modes, player/missile graphics, priority and collisions.hardware/pokey.md — POKEY audio, timers, IRQs, random/noise polynomials, keyboard/serial/SIO clocking.
2. system/ — OS, Memory, I/O, Compatibility
system/memory-map.md — 64K memory map, zero page, PIA, PORTB banking, extended RAM detection.system/os-vectors-handlers.md — OS vectors, VBI/DLI/CIO/SIO entry points, IOCB lifecycle, handler tables, safe hook patterns.system/os-hardening.md — OS ROM disable, trampoline handlers, RESET survival, VCOUNT/VBLANK bare-metal sync.system/storage.md — SIO protocol, disk commands, XEX/ATR formats, CIO file access, SpartaDOS X, loader/depacker reversing.system/screen.md — ATASCII, screen codes, CIO GET/PUT/PRINT, keyboard codes, number display.system/input.md — Joysticks, paddles, mouse, light pen, console keys, trigger registers.system/compatibility.md — 400/800 vs XL/XE, PAL/NTSC, RAM expansions, CPU/chip/upgrades detection matrix.system/cartridges-pbi.md — Cartridge windows, banking, PBI devices, internal devices, reverse-engineering notes.
3. graphics/ — Rendering Techniques
graphics/display-lists.md — DLI routines, display-list instruction set, LMS/JVB, WSYNC, multi-zone DLI patterns.graphics/character-modes.md — ANTIC text modes, fonts, CHBASE/CHACTL, blink/inversion, character-mode plotting.graphics/bitmap-modes.md — Hires and multicolor bitmap modes, 240-line tricks, custom video modes.graphics/pm-graphics.md — Hardware player/missile setup, movement, multiplexing, priority, and collision detection.graphics/software-sprites.md — CPU-rendered bitmap/character software sprites, save/restore, XOR, pre-shift tables, dirty buffers, collision tests.graphics/scrolling.md — Coarse/fine vertical and horizontal scroll, VSCROL/HSCROL, parallax, MWP buffering.graphics/advanced-fx.md — HIP, RIP, TIP, GTIA 9++, interlaced shade/color techniques.
4. audio/ — Sound and Music
audio/synthesis.md — POKEY synthesis, distortion tables, filters, linked 16-bit channels, double POKEY.audio/digital-audio.md — 4-bit PCM/PDM playback, volume-only mode, VCOUNT-sync sample playback.audio/trackers.md — RMT and TMC2 playback engines, interrupt coexistence, tracker data layout.
5. algorithms/ — Code Patterns
algorithms/math.md — 8/16/32-bit multiply/divide, modulo, LUT math, atan2, sqrt, distance.algorithms/bit-ops.md — Bit shifts/rotates, flag testing, zero-page idioms, INC/DEC hardware hazards.algorithms/optimization.md — 6502 size/speed patterns, jump tables, compare-free loops, flag-preserving tests.algorithms/compression.md — RLE, LZ4, Exomizer, DEFLATE decompression patterns.algorithms/3d-graphics.md — Real-time 3D: fixed-point math, rotation/projection, span-buffer rasterization & fill strategies, Gouraud shading & texturing, GTIA luminance display modes, double buffering, culling & depth sort.algorithms/sorting.md — 8/16-bit optimal sorts, bucket sort, CombSort, ShellSort, Quicksort.algorithms/macros.md — Reusable MADS macros for memory, arithmetic, shifting, interpolation.
6. tooling/ — Build, Examples, Reversing
tooling/mads-assembler.md — Compact MADS syntax, directives, macros, procedures, banks, relocatables, 65816 addenda. For full MADS assembler documentation, use the standalone mads/ skill.tooling/code.md — Ready-to-read examples: sieve, Tetris, RLE, GTIA 9++, 40x40, demoscene catalog.tooling/reversing.md — XEX/ATR/source/listing triage, segment maps, depackers, Altirra tracing, hardware breakpoints.
7. exotics/ — Upgrades and Peripherals
exotics/vbxe.md — VBXE FX core, detection, XDL, blitter, VRAM, palette, MEMAC windows, examples.exotics/sophia-rapidus.md — Sophia video upgrades, Rapidus/65C816 notes, APE-Time RTC, LDW/CA-2001 device protocol.exotics/fujinet.md — FujiNet network programming, N: device CIO handler, TCP/UDP sockets, HTTP requests, SIO protocol, and JSON parsing.
Navigation Rules
- Hardware-register behavior belongs in
hardware/; software rendering recipes belong in graphics/.
- OS/device/file/vector questions belong in
system/; build examples and reverse workflows belong in tooling/.
- Prefer the narrowest topic file that directly matches the request.
- If a task needs both hardware facts and implementation guidance, load the hardware topic first, then the graphics, audio, system, or tooling topic that covers the code path.
- When copying assembly snippets, copy the whole contract: routine, declared input/output registers or memory, scratch bytes, required lookup tables, and any init routine. If a topic provides generated tables, prefer those over incomplete symbolic table names.
