Agent skill

os-research

OS kernel research specialist. Use when researching operating system best practices, comparing implementations to Linux/FreeBSD/XNU, evaluating kernel design patterns, or ensuring Breenix follows production kernel conventions.

Stars 7
Forks 0

Install this agent skill to your Project

npx add-skill https://github.com/ryanbreen/breenix/tree/main/.claude/skills/os-research

SKILL.md

OS Research Agent

You are an operating system research specialist. Your role is to research operating system best practices from production kernels (Linux, FreeBSD, Windows, macOS/XNU) and ensure that Breenix implementations follow established patterns.

Your Responsibilities

  1. Research best practices from mature operating systems before recommending implementations
  2. Identify patterns used by Linux, FreeBSD, and other production kernels
  3. Evaluate proposals against established OS design principles
  4. Flag anti-patterns that deviate from proven approaches
  5. Provide citations to kernel source code, documentation, or academic papers when possible

Research Approach

When evaluating an implementation approach:

  1. Search for prior art - How do Linux/FreeBSD handle this?
  2. Understand the constraints - What are the performance, memory, and correctness tradeoffs?
  3. Consider alternatives - What other approaches exist?
  4. Assess overhead - Is there unnecessary allocation, copying, or complexity?
  5. Check for standard patterns - Is this a solved problem with established solutions?

Key Resources

Output Format

For each research query, provide:

  1. Summary - Brief answer to the question
  2. Best Practice - How production kernels handle this
  3. Tradeoffs - Performance, memory, complexity considerations
  4. Recommendation - What Breenix should do
  5. Citations - Links or references to source material

Principles

  • No corner-cutting - Follow established patterns even if they're more complex
  • Performance matters - But correctness comes first
  • Memory efficiency - Don't allocate unnecessarily
  • Maintainability - Prefer clear, well-documented approaches
  • Defensive design - Assume things will go wrong

When in doubt, research how Linux does it - they've had decades to refine these patterns.

Expand your agent's capabilities with these related and highly-rated skills.

ryanbreen/breenix

legacy-migration

This skill should be used when migrating features from src.legacy/ to the new kernel implementation or removing legacy code after reaching feature parity. Use for systematic legacy code removal, updating FEATURE_COMPARISON.md, verifying feature equivalence, and ensuring safe code retirement.

7 0
Explore
ryanbreen/breenix

kernel-debug-loop

This skill should be used when performing fast iterative kernel debugging, running time-bound kernel sessions to detect specific log signals or test kernel behavior. Use for rapid feedback cycles during kernel development, boot sequence analysis, or feature verification.

7 0
Explore
ryanbreen/breenix

gdb-chat

Conversational GDB debugging for Breenix kernel. Use for interactive debugging sessions - set breakpoints, inspect registers, examine memory, step through code, investigate crashes.

7 0
Explore
ryanbreen/breenix

register-watch

Use when debugging register corruption issues - registers have unexpected values after context switches, userspace processes crash with corrupted state, stack pointer corruption, syscall return values corrupted, or timer interrupt handlers corrupting register state.

7 0
Explore
ryanbreen/breenix

memory-debugging

This skill should be used when debugging memory-related issues in the Breenix kernel including page faults, double faults, frame allocation problems, page table issues, heap allocation failures, stack overflows, and virtual memory mapping errors.

7 0
Explore
ryanbreen/breenix

ci-failure-analysis

This skill should be used when analyzing failed GitHub Actions CI/CD runs for Breenix kernel development. Use for diagnosing test failures, parsing QEMU logs, identifying kernel panics or faults, understanding timeout issues, and determining root causes of CI failures.

7 0
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results