debug-amiga

...

30|2|Updated Mar 20, 2026

Search Tags:#automation #debugging #crash-analysis #enforcer #port-testing #amiga #fs-uae

Ready to run

npx skills add https://github.com/bdgscotland/amiport --skill debug-amiga

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: debug-amiga
Source: https://github.com/bdgscotland/amiport/tree/main/.claude/skills/debug-amiga
Command: npx skills add https://github.com/bdgscotland/amiport --skill debug-amiga

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Debugging Amiga ports can be time-consuming due to runtime crashes and opaque crash reports. This skill captures Enforcer hits during port execution and runs an autonomous fix loop to propose and apply patches, then rebuilds and retests.

Core Features & Use Cases

Capture and map Enforcer hits to source locations to identify crash causes.
Autonomous fix loop that classifies crashes, applies safety-aware patches, and revalidates by rebuilding and re-running tests.
Scales across multiple ports and can be invoked after a port builds but crashes at runtime.

Quick Start

Run /debug-amiga <port-directory> to start the autonomous crash-fix loop.

Frequently Asked Questions about debug-amiga

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

FAQPage Schema

How do I automate debugging for AmigaOS 3.x port crashes?▼

Automate AmigaOS 3.x port crash debugging by using an autonomous fix loop that captures Enforcer hits, proposes patches, and rebuilds. It runs up to five iterations to automatically resolve runtime crashes under FS-UAE.

Can I use FS-UAE with Enforcer to map runtime crashes to source code?▼

FS-UAE with Enforcer captures runtime hits and maps them to source locations to identify crash causes. This requires binaries built with appropriate debugging info to accurately trace failures back to the original code.

What do I need to set up before running autonomous Amiga port crash analysis?▼

Amiga port crash analysis requires binaries built with debugging info, scripts/test-fsemu.sh, and scripts/debug-report.py. You must invoke the workflow on a port directory that successfully builds and runs under FS-UAE with Enforcer enabled.

What is the best way to fix Amiga ports that build successfully but crash at runtime?▼

Fix Amiga ports that crash at runtime by dispatching an autonomous fix loop that classifies crashes and applies safety-aware patches. It revalidates fixes by automatically rebuilding and re-running tests up to five iterations.

Why does my Amiga port crash loop fail to apply patches after five iterations?▼

The autonomous fix loop is constrained to a maximum of five patch, rebuild, and re-test iterations. If the runtime crash remains unresolved after these cycles, the workflow stops to prevent unbounded automated patching.

Does the autonomous Amiga debugging workflow scale across multiple port directories?▼

The autonomous debugging workflow scales across multiple Amiga port directories. It can be invoked on any port directory that builds and runs under FS-UAE, applying the crash-fix loop to resolve runtime failures across different ports.