К основному содержанию
скилл CX Codex

faebryk — скилл для Claude Code: что делает и как установить

Скилл объясняет устройство TypeGraph в faebryk и помогает разбирать обход графа, ссылки и типы рёбер. Нужен при работе с FabLL и Zig-частью ядра.

MIT 1 установок ★ 4 090 обновлён 2026-10-14

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add atopile/atopile --skill faebryk -a claude-code
Открыть на GitHub

Что делает 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-code

2Вручную: положить файлы

~/.claude/skills/faebryk/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/faebryk/

По шагам, с командами для каждой платформы: Как установить скилл в 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

Похожие скиллы

Все скиллы по теме «Языки программирования» →
zig-compiler mohitmishra786 Скилл zig-compiler ведёт агента по вызову компилятора Zig: режимы оптимизации, типы сборки, zig cc вместо C-компилятора и разбор сообщений об ошибках. CX Codex +1 529установок zig-comptime mohitmishra786 Скилл zig-comptime для агентов, который помогает писать обобщённые функции, рефлексию типов и код, вычисляемый на этапе компиляции в Zig. CX Codex +1 521установок mpc-plugin-build inmusic-software Скилл mpc-plugin-build для Claude Code собирает проект MPC-плагина в папку для установки и помогает исправлять ошибки сборки. Запускается, когда нужно скомпилировать плагин или сборка завершается с ошибкой. CX Codex +1 ★ 200звёзд репо native-sdk vercel-labs Помогает ИИ-агенту создавать десктопные приложения через Native SDK на TypeScript и разметке .native. Помогает настроить сборку, интерфейс и встроенную автоматизацию. CX Codex +1 1 500установок cmux-ghostty manaflow-ai Скилл cmux-ghostty регламентирует работу с сабмодулем Ghostty и сборку GhosttyKit в репозитории cmux. Пригодится при синхронизации форка и обновлении указателей Git. CX Codex +1 4 900установок clawd-code-python-port reason-machines Скилл clawd-code-python-port для Claude Code переносит каркас агентной среды на Python и связывает инструменты, команды и задачи. Описывает устройство проекта для изучения и расширения. CX Codex +1 764установок

Из того же набора2

Спонсоры проекта

Компании, которые помогают держать аналитику открытой