osdev-toolchain

Community

Set up cross-compilers and debug kernels with QEMU

AuthorMaelwalser
Version1.0.0
Installs0

System Documentation

What problem does it solve?

This Skill removes the uncertainty and friction of bare-metal OS development by documenting how to build and use cross-compilers, author linker scripts, integrate assembly and C, and debug kernel images with emulators so developers avoid host-tool mismatches and linking/runtime errors.

Core Features & Use Cases

  • Cross-compiler build and verification: step-by-step instructions to build binutils, GCC (or use Clang), and optional GDB for common targets like i686-elf, x86_64-elf, arm-none-eabi, aarch64-none-elf, and riscv64-unknown-elf.
  • Linker script and symbol guidance: templates and annotated examples for 32-bit, 64-bit higher-half, and embedded MEMORY layouts plus guidance on VMA vs LMA and KEEP usage.
  • Assembly and build system patterns: NASM vs GAS differences, calling conventions, Makefile templates for out-of-tree builds, and ISO/ISO+QEMU workflows for building and running kernels.
  • Emulator debugging workflows: QEMU flags, GDB remote workflows, .gdbinit suggestions, and Bochs vs QEMU tradeoffs for deep x86 debugging.
  • Use Case: Prepare a freestanding kernel project, build a cross-toolchain, link with a custom linker script, and debug kernel entry and paging issues in QEMU with a GDB connection.

Quick Start

Use the osdev-toolchain guide to build an i686-elf cross-compiler, produce a kernel.elf with the provided Makefile template, and launch it in QEMU for interactive debugging.

Dependency Matrix

Required Modules

None required

Components

references

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: osdev-toolchain
Download link: https://github.com/Maelwalser/claude-config/archive/main.zip#osdev-toolchain

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.