Skip to content
Skills Library
Programming · Learning & explanation

linux-kernel-architecture

/linux-kernel-architecture

Linux kernel architecture skill for subsystem overview. Use when navigating kernel source, understanding boot flow, initcalls, or major subsystems (VFS, scheduler, MM). Activates on queries about kernel architecture, boot process, initcall levels, subsystem layout, or where code lives in linux.git.

Licence
MIT
Last repository change
27.06.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 27.06.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Linux kernel architecture skill for subsystem overview. Use when navigating kernel source, understanding boot flow, initcalls, or major subsystems (VFS, scheduler, MM). Activates on queries about kernel architecture, boot process, initcall levels, subsystem layout, or where code lives in linux.git.

Original author description

Linux kernel architecture skill for subsystem overview. Use when navigating kernel source, understanding boot flow, initcalls, or major subsystems (VFS, scheduler, MM). Activates on queries about kernel architecture, boot process, initcall levels, subsystem layout, or where code lives in linux.git.

How it works

  1. Purpose
  2. When to Use
  3. Workflow
  4. Common Problems
  5. Related Skills
Original SKILL.md headings · 86 lines, 367 words
SKILL.md preview
---
name: linux-kernel-architecture
description: Linux kernel architecture skill for subsystem overview. Use when navigating kernel source, understanding boot flow, initcalls, or major subsystems (VFS, scheduler, MM). Activates on queries about kernel architecture, boot process, initcall levels, subsystem layout, or where code lives in linux.git.
---

# Linux Kernel Architecture

## Purpose

Provide a mental map of the Linux kernel: boot sequence, major subsystems, key data structures, and where to look in source — complementing `skills/kernel/kernel-internals` with architecture-level navigation for driver and subsystem work.

## When to Use

- First time exploring `linux.git` for a feature or bug
- Understanding how boot reaches `init` and driver `probe`
- Tracing a syscall or interrupt through subsystems
- Onboarding before `skills/kernel-dev/platform-device-model` or driver skills

## Workflow

### 1. Boot flow (x86/ARM64 simplified)

```
firmware/UEFI
├── arch/*/boot — decompress kernel, early setup
├── start_kernel() — mm, scheduler, timers, IRQ subsys
├── rest_init() → kernel_init → run_init_process
└── userspace init (systemd)
```

Driver `module_init` / `device_initcall` run during `start_kernel` before init.

### 2. Major subsystems

| Subsystem | Path (typical) | Key structs |
|-----------|----------------|-------------|
| Scheduler | `kernel/sched/` | `task_struct`, `sched_entity` |
| Memory | `mm/` | `struct page`, `mm_struct`, `vm_area_struct` |
| VFS | `fs/` | `inode`, `dentry`, `file`, `super_block` |
| Block | `block/` | `request_queue`, `gendisk` |
| Net | `net/` | `sk_buff`, `net_device` |
| Drivers | `drivers/` | `device`, `device_driver` |
| Syscalls | `kernel/`, `fs/`, `mm/` | `SYSCALL_DEFINE*` |

### 3. Initcall levels

```c
/* include/linux/init.h — order matters */
early_initcall → core_initcall → postcore_initcall
→ arch_initcall → subsys_initcall → fs_initcall
→ device_initcall → late_initcall
```

Platform drivers usually register at `subsys_initcall` or via `module_init`.

### 4. Finding code

```bash
# Locate symbol
grep -rn "platform_driver_register" drivers/

# Trace config
./scripts/config --state CONFIG_FOO

# File hierarchy docs
ls Documentation/admin-guide/
```

### 5. Agent usage

```
/linux-kernel-architecture Where does page fault handling live and what calls it?
```

## Common Problems

| Symptom | Cause | Fix |
|---------|-------|-----|
| Driver probes too early | Initcall vs DT ordering | Defer with `deferred_probe` |
| Symbol missing | Built as module | `modprobe` or built-in `CONFIG_*` |
| Wrong subsystem | Similar names in `drivers/` | Follow `struct bus_type` |
| Boot hang | Early printk disabled | `earlyprintk`, `initcall_debug` |

## Related Skills

- `skills/kernel/kernel-internals` — scheduler, SLUB, VFS depth
- `skills/kernel-dev/kernel-memory-management` — mm/ details
- `skills/kernel-dev/platform-device-model` — driver model
- `skills/kernel-dev/device-tree` — hardware description
- `skills/low-level-programming/linux-kernel-modules` — LKM basics

Versions

RepositoryScoreLicence
This page · mohitmishra786/low-level-dev-skills100MIT
OutlineDriven/outline-driven-development100Apache-2.0

Database snapshot: 13.11.2026 · package version ee98efe1ce13 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100kernel-internals
    Linux kernel internals skill for scheduler, memory, and VFS subsystems. Use when analyzing CFS/EEVDF scheduling, buddy/SLUB allocators, page cache, memory zones, OOM killer, or interpreting /proc/meminfo. Activates on queries about kernel scheduler, vruntime, SLUB, vmalloc, page…
  • 100kernel-list-report
    Write and send a report to a Linux kernel mailing list: recipients, plain text, git send-email. Use when reporting to linux-xfs, fsdevel or similar.
  • 100linux-kernel-modules
    Linux kernel module skill for writing and debugging loadable kernel modules. Use when writing LKMs with Kbuild, adding module parameters, creating /proc and sysfs entries, implementing character devices, debugging with KGDB or ftrace, or handling module signing for Secure Boot.…
  • 100kernel-development
    Use this skill when the user says 'kernel module', 'Linux driver', 'device driver', 'ring 0', 'system call', 'interrupt handler', 'spinlock', 'RCU', 'kernel panic', 'oops', 'write an OS', 'bootloader', 'page tables', 'Rust for Linux'. Covers OS internals and Linux kernel…
  • 100device-driver-development
    Use when developing, reviewing, debugging, porting, or engineering Linux kernel device drivers, kernel modules, device tree bindings, bus clients, subsystem drivers, DMA/IRQ/memory paths, userspace interfaces, or hardware bring-up plans.
  • 100kernel-lore-hunter
    追踪 Linux 内核补丁与讨论——从一篇文章、一个 commit、一个分支名、一个符号名或一个话题出发,定位对应的 patchset、LKML/linux-mm/linux-fsdevel 邮件串、维护者 git 分支,并判断版本与是否已合并。Use when the user gives an article, commit hash, branch name, kernel symbol (e.g. PG_rcu_free, filemap_read_rcu_batch) or topic and asks for "the patchset",…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.