Agent Skills › justrach/turboAPI › turbo-build

turbo-build

GitHub

编译 TurboAPI Zig 后端并安装，解决原生核心不可用或依赖哈希不匹配问题。

.claude/skills/turbo-build/SKILL.md justrach/turboAPI

触发场景

Turbonet 扩展需要重新编译修改了 Zig 源代码后遇到 Native core not available 错误

安装

npx skills add justrach/turboAPI --skill turbo-build -g -y

更多选项

非标准路径

npx skills add https://github.com/justrach/turboAPI/tree/main/.claude/skills/turbo-build -g -y

不安装直接使用

npx skills use justrach/turboAPI@turbo-build

指定 Agent (Claude Code)

npx skills add justrach/turboAPI --skill turbo-build -a claude-code -g -y

安装 repo 全部 skill

npx skills add justrach/turboAPI --all -g -y

预览 repo 内 skill

npx skills add justrach/turboAPI --list

SKILL.md

Frontmatter

{
    "name": "turbo-build",
    "description": "Build the TurboAPI Zig native backend. Use when the turbonet extension needs to be recompiled, after changing Zig source files, or when seeing \"Native core not available\".",
    "argument-hint": [
        "--release"
    ],
    "disable-model-invocation": true
}

Build TurboAPI Zig Backend

Steps

Build turbonet:

uv run --python 3.14t python zig/build_turbonet.py --install $ARGUMENTS

Verify the build:

uv run --python 3.14t python -c "from turboapi import turbonet; print(turbonet.hello())"

Dependencies (auto-fetched via build.zig.zon)

dhi (justrach/dhi) — Zig-native JSON validation
pg.zig (justrach/pg.zig) — Zig-native Postgres client with SIMD + pgvector

Common issues

"Native core not available": Rebuild with the command above
dhi hash mismatch: cd zig && zig fetch --save "https://github.com/justrach/dhi/archive/refs/heads/main.tar.gz"
pg.zig hash mismatch: cd zig && zig fetch --save "git+https://github.com/justrach/pg.zig#master"
Missing Python 3.14t: uv python install 3.14t
Missing Zig 0.15+: brew install zig or download from ziglang.org