{"_id":"@alijemo/zk-skill-package","name":"@alijemo/zk-skill-package","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@alijemo/zk-skill-package","version":"1.0.0","description":"YOU OS / ZiqaKernel agent accelerator","main":"bin/zk-setup.js","bin":{"zk-init":"bin/zk-init.js"},"repository":{"type":"git","url":"git+https://github.com/Ali-Jemo/zk-skill-package.git"},"author":{"name":"Ali Hussein"},"license":"MIT","dependencies":{"fs-extra":"^11.3.6"},"_id":"@alijemo/zk-skill-package@1.0.0","gitHead":"7fcb18608055e1c445458e314d89ac49fe48c999","bugs":{"url":"https://github.com/Ali-Jemo/zk-skill-package/issues"},"homepage":"https://github.com/Ali-Jemo/zk-skill-package#readme","_nodeVersion":"26.2.0","_npmVersion":"10.9.8","dist":{"integrity":"sha512-fn/OOQLlEl05EpI0b5yRcZdHsfepIRFh7soPrzZLpYlTNtkTTHT7SMk41eDL+p4Yd7S5Ue/s42BlDgdAST5R3Q==","shasum":"685cc46f0168917c7b5c2512a6bd9eae1ec26dc8","tarball":"https://registry.npmjs.org/@alijemo/zk-skill-package/-/zk-skill-package-1.0.0.tgz","fileCount":83,"unpackedSize":216200,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIGXfJveXmazAjz5uNTyQFpqSzaUs7SQ9sIKqcbnGLzHqAiEAjKYrN8/t2Dg6BgNzu19KBAIlGEYh76cIdSlI+DmovTM="}]},"_npmUser":{"name":"alijemo","email":"logins2000a.j@gmail.com"},"directories":{},"maintainers":[{"name":"alijemo","email":"logins2000a.j@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/zk-skill-package_1.0.0_1783416256310_0.8738623147241391"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-07T09:24:16.145Z","1.0.0":"2026-07-07T09:24:16.445Z","modified":"2026-07-07T09:24:16.667Z"},"maintainers":[{"name":"alijemo","email":"logins2000a.j@gmail.com"}],"description":"YOU OS / ZiqaKernel agent accelerator","homepage":"https://github.com/Ali-Jemo/zk-skill-package#readme","repository":{"type":"git","url":"git+https://github.com/Ali-Jemo/zk-skill-package.git"},"author":{"name":"Ali Hussein"},"bugs":{"url":"https://github.com/Ali-Jemo/zk-skill-package/issues"},"license":"MIT","readme":"# YOU OS / ZiqaKernel Agent Accelerator\n\nComprehensive toolkit for Rust `no_std` kernel development: diagnostic skills, integrated MCP server, and **internet research** across 15+ platforms.\n\n## Quick Start\n\n```bash\nnpx zk-skill-package@latest\n```\n\nThis installs all skills, commands, MCP rules, and the `agent-reach` research tool.\n\n## Features\n\n### Kernel Development\n- **Master Skill** (`you-os-kernel-accelerator`): Full diagnostic framework, Ponytail policy, Rust kernel discipline.\n- **10 Subsystem Skills**: ELF, scheduler, GUI, memory, IPC, input, driver, syscall debug + project rules.\n- **MCP Server**: `kernel.diagnose`, `kernel.errmem_*`, `kernel.security_audit`, `kernel.invariant_check`, and more.\n- **Slash Commands**: `/zk`, `/zk-fix`, `/zk-plan`, `/zk-review`, `/zk-elf`, `/zk-sched`, `/zk-gui`, `/zk-mem`, `/zk-ipc`, `/zk-input`, `/zk-driver`.\n\n### Internet Research (NEW)\n- **15 Platforms**: Web search, GitHub, YouTube, Bilibili, Twitter/X, Xiaohongshu, Reddit, V2EX, Facebook, Instagram, LinkedIn, RSS, podcasts, 雪球 finance.\n- **Zero-Config Channels**: V2EX, RSS, web reading (Jina Reader), Bilibili search (bili-cli).\n- **Login-Based Channels**: Twitter, Xiaohongshu, Reddit, Facebook, Instagram, LinkedIn (via OpenCLI browser extension).\n- **Research Workflows**:\n  - Hardware datasheet lookup\n  - Reference implementation search (Linux kernel, Rust OS projects)\n  - Crate/API documentation research\n  - Error/symptom pattern search\n  - Multi-platform parallel research with task subagents\n  - Research caching to `/tmp/`\n- **Commands**: `/zk-research`\n- **Skill**: `zk-research`\n\n### Research-to-Fix Pipeline\n\n```text\nunknown component → research profiles → reference impl → minimal patch → verify\n```\n\nWhen a kernel bug involves unknown hardware or unfamiliar errors, research is a **mandatory first step** before patching.\n\n## Architecture\n\n```\nuser request\n  ├─ kernel work → you-os-kernel-accelerator → subsystem skill → fix\n  └─ research   → agent-reach doctor --json → platform tools → report\n```\n\n## MCP Server Configuration\n\nAdd to your agent's MCP config:\n\n```json\n{\n  \"mcpServers\": {\n    \"kernel-engineering\": {\n      \"command\": \"/path/to/project/.agents/mcp-server/run-mcp.sh\",\n      \"args\": [],\n      \"env\": {}\n    }\n  }\n}\n```\n\n\n---\n\n### Self-Improving Skill System (NEW)\n\nThe skill evolves with every fix. After each kernel bugfix, the `zk-fix` workflow records the pattern:\n\n```bash\n./scripts/skill-evolve.sh learn \\\n  --subsystem \"<subsystem>\" \\\n  --symptom \"<symptom>\" \\\n  --fix \"<fix description>\" \\\n  --files \"<files changed>\" \\\n  --verification \"<verification command>\"\n```\n\n**Quality gates** prevent bloat:\n- **Proven**: verification required (not guesses)\n- **Specific**: exact files + code changes needed\n- **Unique**: no duplicate with existing patterns\n- **Signal**: typo/config/trivial fixes rejected\n\n**Promotion**: Patterns promoted to skill files when:\n- Same fix applied 2+ times, OR critical subsystem\n- Fits existing section structure\n- Max 3 per consolidation run\n\n```bash\n./scripts/skill-evolve.sh consolidate   # promote patterns to skills\n./scripts/skill-evolve.sh status        # show evolution state\n./scripts/skill-evolve.sh list          # list all patterns\n```\n## Commands\n\nAll available slash commands:\n\n| Command | Purpose |\n|---------|---------|\n| `/zk` | Master kernel workflow (auto-routes) |\n| `/zk-fix` | Kernel bugfix workflow |\n| `/zk-plan` | Safe planning workflow |\n| `/zk-review` | Patch review |\n| `/zk-elf` | ELF loader diagnostics |\n| `/zk-sched` | Scheduler diagnostics |\n| `/zk-gui` | GUI/framebuffer diagnostics |\n| `/zk-mem` | Memory/page fault diagnostics |\n| `/zk-ipc` | IPC/SHM diagnostics |\n| `/zk-input` | Input diagnostics |\n| `/zk-driver` | Driver diagnostics |\n| `/zk-research` | Internet research (15+ platforms) |\n\n## Documentation\n\n| Document | Description |\n|----------|-------------|\n| `docs/RESEARCH.md` | Full research guide with all platform commands |\n| `docs/COMMANDS.md` | Complete command reference |\n| `AGENTS.md` | Agent rules, GitNexus, graphify, project overview |\n| `.agents/skills/you-os-kernel-accelerator/SKILL.md` | Master kernel skill |\n\n## Manual Installation\n\n```bash\ngit clone https://github.com/Ali-Jemo/zk-skill-package .agents-temp\nchmod +x .agents-temp/scripts/install-zk-agent.sh\n./.agents-temp/scripts/install-zk-agent.sh\nrm -rf .agents-temp\n```\n\n## License\n\nMIT\n","readmeFilename":"README.md","_rev":"1-959a351b438d795b4d3af41c229ea1f5"}