YOU OS / ZiqaKernel Agent Accelerator

Comprehensive toolkit for Rust no_std kernel development: diagnostic skills, integrated MCP server, and internet research across 15+ platforms.

Quick Start

npx zk-skill-package@latest

This installs all skills, commands, MCP rules, and the agent-reach research tool.

Features

Kernel Development

• Master Skill (you-os-kernel-accelerator): Full diagnostic framework, Ponytail policy, Rust kernel discipline.
• 10 Subsystem Skills: ELF, scheduler, GUI, memory, IPC, input, driver, syscall debug + project rules.
• MCP Server: kernel.diagnose, kernel.errmem_*, kernel.security_audit, kernel.invariant_check, and more.
• Slash Commands: /zk, /zk-fix, /zk-plan, /zk-review, /zk-elf, /zk-sched, /zk-gui, /zk-mem, /zk-ipc, /zk-input, /zk-driver.

Internet Research (NEW)

• 15 Platforms: Web search, GitHub, YouTube, Bilibili, Twitter/X, Xiaohongshu, Reddit, V2EX, Facebook, Instagram, LinkedIn, RSS, podcasts, 雪球 finance.
• Zero-Config Channels: V2EX, RSS, web reading (Jina Reader), Bilibili search (bili-cli).
• Login-Based Channels: Twitter, Xiaohongshu, Reddit, Facebook, Instagram, LinkedIn (via OpenCLI browser extension).
• Research Workflows:
  • Hardware datasheet lookup
  • Reference implementation search (Linux kernel, Rust OS projects)
  • Crate/API documentation research
  • Error/symptom pattern search
  • Multi-platform parallel research with task subagents
  • Research caching to /tmp/
• Commands: /zk-research
• Skill: zk-research

Research-to-Fix Pipeline

unknown component → research profiles → reference impl → minimal patch → verify

When a kernel bug involves unknown hardware or unfamiliar errors, research is a mandatory first step before patching.

Architecture

user request
  ├─ kernel work → you-os-kernel-accelerator → subsystem skill → fix
  └─ research   → agent-reach doctor --json → platform tools → report

MCP Server Configuration

Add to your agent's MCP config:

{
  "mcpServers": {
    "kernel-engineering": {
      "command": "/path/to/project/.agents/mcp-server/run-mcp.sh",
      "args": [],
      "env": {}
    }
  }
}

Self-Improving Skill System (NEW)

The skill evolves with every fix. After each kernel bugfix, the zk-fix workflow records the pattern:

./scripts/skill-evolve.sh learn \
  --subsystem "<subsystem>" \
  --symptom "<symptom>" \
  --fix "<fix description>" \
  --files "<files changed>" \
  --verification "<verification command>"

Quality gates prevent bloat:

• Proven: verification required (not guesses)
• Specific: exact files + code changes needed
• Unique: no duplicate with existing patterns
• Signal: typo/config/trivial fixes rejected

Promotion: Patterns promoted to skill files when:

• Same fix applied 2+ times, OR critical subsystem
• Fits existing section structure
• Max 3 per consolidation run

./scripts/skill-evolve.sh consolidate   # promote patterns to skills
./scripts/skill-evolve.sh status        # show evolution state
./scripts/skill-evolve.sh list          # list all patterns

Commands

All available slash commands:

| Command | Purpose | |---------|---------| | /zk | Master kernel workflow (auto-routes) | | /zk-fix | Kernel bugfix workflow | | /zk-plan | Safe planning workflow | | /zk-review | Patch review | | /zk-elf | ELF loader diagnostics | | /zk-sched | Scheduler diagnostics | | /zk-gui | GUI/framebuffer diagnostics | | /zk-mem | Memory/page fault diagnostics | | /zk-ipc | IPC/SHM diagnostics | | /zk-input | Input diagnostics | | /zk-driver | Driver diagnostics | | /zk-research | Internet research (15+ platforms) |

Documentation

| Document | Description | |----------|-------------| | docs/RESEARCH.md | Full research guide with all platform commands | | docs/COMMANDS.md | Complete command reference | | AGENTS.md | Agent rules, GitNexus, graphify, project overview | | .agents/skills/you-os-kernel-accelerator/SKILL.md | Master kernel skill |

Manual Installation

git clone https://github.com/Ali-Jemo/zk-skill-package .agents-temp
chmod +x .agents-temp/scripts/install-zk-agent.sh
./.agents-temp/scripts/install-zk-agent.sh
rm -rf .agents-temp

License

MIT