skills.rest
bdgscotland
bdgscotlandCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

debug-amiga

...

30|2|Updated Mar 20, 2026
Search Tags:#automation#debugging#crash-analysis#enforcer#port-testing#amiga#fs-uae
One-click install
npx skills add https://github.com/bdgscotland/amiport --skill debug-amiga
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
bdgscotlandbdgscotland
30

port-project

Port C projects to AmigaOS 3.x through an end-to-end pipeline.

Community
Advanced
bdgscotlandbdgscotland
30

analyze-source

Analyze C source code for Amiga portability blockers and generate a structured porting report.

Community
Advanced
Alex1980AlexAlex1980Alex

hooks-skills-mcp-triad

Map hooks, skills, and MCP tooling within the PDF Framework.

Community
Intermediate
Maj3D10Maj3D10
1

autonomous-loops

Resolve .NET build and test failures through bounded autonomous iteration loops.

Community
Advanced