faebryk — скилл для Claude Code: что делает и как установить
Скилл объясняет устройство TypeGraph в faebryk и помогает разбирать обход графа, ссылки и типы рёбер. Нужен при работе с FabLL и Zig-частью ядра.
MIT 1 установок ★ 4 090 обновлён 2026-10-14
npx skills add atopile/atopile --skill faebryk -a claude-codeЧто делает faebryk
faebryk даёт агенту контекст по TypeGraph, GraphView и рёбрам, реализованным в Zig и доступным из Python через faebryk.core.faebrykpy. Скилл помогает отличать узлы типов от узлов экземпляров, разбирать EdgeComposition, EdgeTrait, EdgePointer и другие связи, а также строить обходы через EdgeTraversal.
В описании задействованы src/faebryk/core/faebrykpy.py, Python-стабы typegraph.pyi и Zig-исходники src/faebryk/core/zig/src/faebryk/*. Агент также видит зависимые части FabLL, компилятора, решателя и build/export pipeline. Для типобезопасного поиска скилл советует использовать EdgeTrait.traverse(trait_type=SomeTrait) и явно задавать смысл рёбер.
Изменения в Zig требуют пересборки bindings командой ato dev compile, иначе Python-обёртка не получит обновлённое поведение. Для проверки предусмотрены тесты TypeGraph, runtime и Zig-обхода через ato dev test --llm.
Какие задачи решает
- разобрать устройство TypeGraph и GraphView
- найти путь через composition, pointer или trait-рёбра
- сопоставить FabLL-типы и traits с типами рёбер
- написать type-aware query по графу
- проверить Zig-обход и runtime-поведение
Примеры запросов агенту
- Объясни, как связаны
GraphView,TypeGraphи узлы экземпляров. - Покажи, как построить обход trait через
EdgeTrait.traverse(trait_type=SomeTrait). - Проверь изменения в
src/faebryk/core/zig/src/faebryk/*и подскажи, какие тесты запустить.
Как установить faebryk
1Через Skills CLI (Vercel)
npx skills add atopile/atopile --skill faebryk -a claude-code2Вручную: положить файлы
~/.claude/skills/faebryk/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/faebryk/
1Через Skills CLI (Vercel)
npx skills add atopile/atopile --skill faebryk -a codex2Вручную: положить файлы
.agents/skills/faebryk/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add atopile/atopile --skill faebryk -a cursor2Вручную: положить файлы
.cursor/skills/faebryk/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install atopile/atopile .claude/skills/faebryk2Вручную: положить файлы
.github/skills/faebryk/SKILL.md1Через Skills CLI (Vercel)
npx skills add atopile/atopile --skill faebryk -a gemini-cli2Командой платформы
gemini skills install https://github.com/atopile/atopile --path .claude/skills/faebrykВручную: положить файлы
.devin/skills/faebryk/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add atopile/atopile --skill faebryk -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о faebryk
Как установить faebryk в Claude Code?
Выполните npx skills add atopile/atopile --skill faebryk -a claude-code, затем проверьте файл ~/.claude/skills/faebryk/SKILL.md.
Что делает faebryk?
Скилл помогает работать с TypeGraph: обходить ссылки, понимать семантику рёбер и связывать FabLL-типы и traits с графом.
Что нужно сделать после правок Zig-части?
После изменений в src/faebryk/core/zig/src/faebryk/* нужно пересобрать bindings командой ato dev compile.
Исходный текст
SKILL.md · MIT
--- name: faebryk description: "How Faebryk's TypeGraph works (GraphView + Zig edges), how to traverse/resolve references, and how FabLL types/traits map onto edge types. Use when working with TypeGraph traversal, edge types, or building type-aware queries." --- # Faebryk Core Module The Faebryk core here is the **TypeGraph** + edge types implemented in Zig and exposed to Python via `faebryk.core.faebrykpy`. Source-of-truth for API + behavior: - `src/faebryk/core/faebrykpy.py` (Python-facing wrapper + type-safe `EdgeTrait.traverse`) - `src/faebryk/core/zig/gen/faebryk/typegraph.pyi` (public stubbed API surface) - `src/faebryk/core/zig/src/faebryk/*` (Zig implementation) ## Quick Start ```python import faebryk.core.faebrykpy as fbrk import faebryk.core.graph as graph g = graph.GraphView.create() tg = fbrk.TypeGraph.create(g=g) ``` ## Relevant Files - `src/faebryk/core/faebrykpy.py` (re-exports + `EdgeTraversal` + type-safe `EdgeTrait.traverse`) - `src/faebryk/core/zig/gen/faebryk/typegraph.pyi` (TypeGraph stub) - Key edge types (imported by `faebrykpy.py`): - `EdgeComposition` (parent/child structure) - `EdgeTrait` / `Trait` (trait attachment) - `EdgePointer` (references) - `EdgeInterfaceConnection` (interface connections) - `EdgeOperand` (solver operand wiring) - `EdgeType` / `EdgeNext` (type graph plumbing) - Linker: - `Linker` (used by compiler/linking stages) ## Dependants (Call Sites) - FabLL: `src/faebryk/core/node.py` (binds Python classes into the TypeGraph; uses composition/trait edges) - Compiler: `src/atopile/compiler/*` (creates and links TypeGraphs) - Solver: `src/faebryk/core/solver/*` (operand edges and instance traversal) - Build/export pipeline: `src/atopile/build_steps.py` (visits type/instance edges for PCB/layout features) ## How to Work With / Develop / Test ### Core Concepts - **GraphView + TypeGraph**: a `TypeGraph` is created against a `GraphView`: ```python import faebryk.core.graph as graph import faebryk.core.faebrykpy as fbrk g = graph.GraphView.create() tg = fbrk.TypeGraph.create(g=g) ``` - **Type nodes vs instance nodes**: - TypeGraph stores type definitions (“what exists structurally on a type”) - GraphView also holds instances created from those types (“a concrete design graph”) - **EdgeTraversal**: `TypeGraph.ensure_child_reference(..., path=[...])` uses `EdgeTraversal` items to walk references through the type graph. ### Development Workflow 1) Zig-side changes: edit `src/faebryk/core/zig/src/faebryk/*` (edges, typegraph internals). 2) Rebuild bindings: `ato dev compile` (imports `faebryk.core.zig`). 3) Python ergonomics: add wrappers/helpers in `src/faebryk/core/faebrykpy.py` (example: type-safe `EdgeTrait.traverse`). ### Testing - TypeGraph-heavy tests live in compiler/runtime suites: - `ato dev test --llm test/compiler/test_typegraph.py -q` - `ato dev test --llm test/compiler/test_runtime.py -q` - Zig-backed traversal tests: - `ato dev test --llm test/core/zig/test_interface_pathfinder.py -q` ## Best Practices - Import edges/TypeGraph via `faebryk.core.faebrykpy` (so callers get Python helpers, not just raw generated types). - Prefer type-safe trait traversal: - `EdgeTrait.traverse(trait_type=SomeTrait)` over stringly-typed `trait_type_name=...`. - When building reference paths, be explicit about edge semantics (composition vs pointer vs trait) rather than relying on implicit string behavior.
© atopile · MIT · atopile/atopile