Kernel Development Skills

Kernel Development Skills

Portable Agent Skill and plugin package for Linux kernel development skills: driver API choices, Kconfig, devicetree bindings and DTS, debugging, tracing, CI failures, KUnit, kselftest, regression and stable handling, maintainer routing, and vendor/LTS kernel maintenance.

The reusable skill lives at:

plugins/kernel-development-skills/skills/kernel-development-skills/

Install

Codex

From this repository root:

codex plugin marketplace add "$PWD"
codex plugin add kernel-development-skills@kernel-development-skills

Claude Code

Inside Claude Code:

/plugin marketplace add /path/to/kernel-development-skills
/plugin install kernel-development-skills@kernel-development-skills

For local development without installation:

claude --plugin-dir ./plugins/kernel-development-skills

Plain Agent Skills

Copy or symlink the skill directory into the agent's supported skill path:

mkdir -p ~/.agents/skills
ln -s "$PWD/plugins/kernel-development-skills/skills/kernel-development-skills" \
  ~/.agents/skills/kernel-development-skills

See adapters/major-agent-setup.md for OpenCode, Copilot, Gemini CLI, Cursor, Windsurf, and other instruction-file based setups.

Regenerate Local Kernel Documentation Routes

The large JSONL documentation index is intentionally not committed. Regenerate it against the kernel checkout you are working in:

python3 plugins/kernel-development-skills/skills/kernel-development-skills/scripts/index_kernel_docs.py \
  /path/to/linux-kernel \
  plugins/kernel-development-skills/skills/kernel-development-skills/references/doc-routes.md \
  --jsonl plugins/kernel-development-skills/skills/kernel-development-skills/assets/kernel-doc-index.jsonl

Query the JSONL with rg or jq, then open only the relevant kernel docs.

Validate

python3 ~/.codex/skills/.system/skill-creator/scripts/quick_validate.py \
  plugins/kernel-development-skills/skills/kernel-development-skills
python3 ~/.codex/skills/.system/plugin-creator/scripts/validate_plugin.py \
  plugins/kernel-development-skills
claude plugin validate plugins/kernel-development-skills
claude plugin validate .
python3 -m py_compile plugins/kernel-development-skills/skills/kernel-development-skills/scripts/*.py
python3 plugins/kernel-development-skills/skills/kernel-development-skills/scripts/check_kernel_api_patterns.py \
  --help >/dev/null

Research provenance from the skill creation pass is kept in research/sources.tsv; it is not loaded during normal skill use.