using-makefiles

Automate creation and understanding of RISC OS AMU makefiles.

3|Updated Apr 10, 2026
One-click install
npx skills add https://github.com/gerph/riscos-agent-skills --skill using-makefiles
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: using-makefiles
Source: https://github.com/gerph/riscos-agent-skills/tree/main/skills/using-makefiles
Command: npx skills add https://github.com/gerph/riscos-agent-skills --skill using-makefiles

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

RISC OS AMU makefiles are complex and require consistent structure; this skill consolidates guidance for creating and maintaining component Makefiles and shared build rules.

Core Features & Use Cases

  • Overview of Makefile types (LibraryCommand, CModule, AsmModule, LibExport, CApp, BasicApp, Documentation, Resource)
  • Instructions on setting variables before and after includes, and how to compose shared Makefiles
  • Build targets, architecture handling, and project scaffolding for debugging and exporting builds
  • Use cases include starting new projects, diagnosing build failures, and exporting artifacts for distribution

Quick Start

Create a new project skeleton with riscos-project and begin editing the Makefile templates to validate the setup

Frequently Asked Questions about using-makefiles

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

FAQPage Schema
What types of RISC OS AMU Makefiles are available for component builds?

Available RISC OS AMU Makefile types include LibraryCommand, CModule, AAsmModule, LibExport, CApp, BasicApp, Documentation, and Resource, each providing standardized build rules for different component structures.

How do I create a new Makefile for a RISC OS CModule component?

To create a CModule Makefile, set required variables before including the shared Makefile, then specify build targets, architecture flags, and project layout rules to reliably build and export the component.

Can I use AMU Makefiles to export RISC OS build artifacts for distribution?

Yes, AMU Makefiles support exporting build artifacts for distribution by defining export targets and following shared Makefile rules for architecture handling and component layout to generate reliable artifacts.

Where should variables be set when composing shared Makefiles in RISC OS?

Variables in RISC OS shared Makefiles must be set both before and after includes, following composition rules to ensure the AMU toolchain correctly processes build targets and architecture flags for the component.

Why is my RISC OS AMU Makefile build failing with architecture flag errors?

AMU Makefile build failures with architecture flags typically occur when variables are not set correctly before or after includes, or when the shared Makefile type does not match the component structure being built.

Does the AMU toolchain support debugging and project scaffolding for RISC OS components?

Yes, the AMU toolchain supports debugging and project scaffolding through Makefile templates that define build targets and project layout rules, enabling developers to validate setups and diagnose build failures during development.