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

reactflow-expert — скилл для Claude Code

Скилл reactflow-expert для Claude Code строит DAG-визуализации на ReactFlow v12. Показывает workflow-графы с кастомными узлами, автораскладкой и живым состоянием выполнения.

MIT 182 установок ★ 274 обновлён 2026-10-30

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

Что делает reactflow-expert

Скилл строит визуализации ориентированных графов на ReactFlow v12: кастомные узлы агентов, рёбра, автораскладка через ELKjs и состояние в Zustand. Живые обновления приходят по WebSocket, поэтому граф перерисовывается по мере выполнения шагов.

Внутри — готовые паттерны: Zustand-стор вместо useNodesState для сложных редакторов, компонент AgentNode с цветами статусов (pending, running, completed, failed и другие), хук useAutoLayout на ELKjs с направлениями DOWN и RIGHT. Панель управления добавляется через Panel из @xyflow/react.

Ограничение из README: nodeTypes нельзя определять внутри компонента, иначе ReactFlow перерегистрирует узлы на каждом рендере. В связке со скиллами websocket-streaming, human-gate-designer и task-decomposer покрывается полный цикл: декомпозиция задач, гейты подтверждения, поток событий. Для статичных Mermaid-диаграмм скилл не подходит — он явно говорит использовать mermaid-graph-writer.

Какие задачи решает

  • собрать DAG-дашборд с кастомными узлами агентов
  • разложить граф автоматически через ELKjs
  • подключить WebSocket-события к состоянию ReactFlow
  • настроить Zustand-стор вместо локального состояния
  • добавить зум, панорамирование и выбор узлов

Примеры запросов агенту

  • Сделай DAG-дашборд для workflow с узлами агентов и автораскладкой
  • Добавь кастомный узел с цветом статуса и бейджами скиллов
  • Подключи WebSocket-стрим выполнения к Zustand и ReactFlow

Как установить reactflow-expert

1Через Skills CLI (Vercel)

npx skills add curiositech/some_claude_skills --skill reactflow-expert -a claude-code

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

~/.claude/skills/reactflow-expert/SKILL.md

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

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о reactflow-expert

Как установить reactflow-expert в Claude Code?

Выполни npx skills add curiositech/some_claude_skills --skill reactflow-expert -a claude-code. Файл скилла появится в ~/.claude/skills/reactflow-expert/SKILL.md.

Что делает reactflow-expert?

Собирает визуализации workflow-графов на ReactFlow v12: кастомные узлы, автораскладка через ELKjs, Zustand для состояния и WebSocket для живых обновлений.

Подходит ли скилл для Mermaid-диаграмм?

Нет, в README прямо указано: для статичных Mermaid-диаграмм используй mermaid-graph-writer. Этот скилл заточен под интерактивные DAG-графы.

Исходный текст

SKILL.md · MIT
---
name: reactflow-expert
description: Builds DAG visualizations using ReactFlow v12 with custom nodes, ELKjs auto-layout, Zustand state management, and live state updates via WebSocket. Use when implementing workflow visualization
  dashboards, creating custom agent node components, integrating ELK layout algorithms, or wiring execution state into React components. Activate on "ReactFlow", "workflow visualization", "DAG visualization",
  "ELKjs", "custom nodes", "node-based editor", "graph visualization". NOT for writing Mermaid diagrams (use mermaid-graph-writer), general React development, or static diagram rendering.
allowed-tools: Read,Write,Edit,Bash,Grep,Glob
metadata:
  tags:
  - reactflow
  - workflow-visualization
  - dag-visualization
  pairs-with:
  - skill: websocket-streaming
    reason: Live DAG state updates flow through WebSocket connections to ReactFlow visualizations
  - skill: human-gate-designer
    reason: Human approval gates are rendered as interactive ReactFlow custom nodes
  - skill: task-decomposer
    reason: Decomposed task DAGs are visualized as ReactFlow node graphs with ELKjs layout
---

# ReactFlow Expert

Builds DAG visualizations using ReactFlow v12 with custom agent nodes, ELKjs auto-layout, Zustand state management, and live execution state updates.

---

## When to Use

✅ **Use for**:
- Building workflow/DAG visualization dashboards
- Creating custom ReactFlow node components for agent state
- Integrating ELKjs auto-layout for automatic graph positioning
- Wiring WebSocket execution events into ReactFlow state
- Implementing zoom, pan, selection, and node interaction

❌ **NOT for**:
- Static Mermaid diagrams (use `mermaid-graph-writer`)
- General React component development
- Non-graph visualizations (charts, tables)

---

## Architecture

```mermaid
flowchart TD
  subgraph "State Layer"
    Z[Zustand Store] --> N[nodes + edges]
    Z --> U[updateNodeData]
    Z --> A[applyNodeChanges / applyEdgeChanges]
  end
  
  subgraph "Layout Layer"
    E[ELKjs] --> P[Compute positions]
    P --> Z
  end
  
  subgraph "Data Layer"
    WS[WebSocket] --> Z
    API[REST API] --> Z
  end
  
  subgraph "Render Layer"
    Z --> RF[ReactFlow component]
    RF --> CN[Custom AgentNode]
    RF --> CE[Custom edges]
    RF --> PA[Panel controls]
  end
```

---

## Core Patterns (ReactFlow v12)

### Zustand Store (Recommended over useNodesState for complex editors)

```typescript
import { create } from 'zustand';
import { applyNodeChanges, applyEdgeChanges, type Node, type Edge } from '@xyflow/react';

interface DAGStore {
  nodes: Node[];
  edges: Edge[];
  onNodesChange: (changes: any) => void;
  onEdgesChange: (changes: any) => void;
  setNodes: (nodes: Node[]) => void;
  setEdges: (edges: Edge[]) => void;
  updateNodeData: (nodeId: string, data: Record<string, any>) => void;
}

const useDAGStore = create<DAGStore>((set, get) => ({
  nodes: [],
  edges: [],
  onNodesChange: (changes) => set({ nodes: applyNodeChanges(changes, get().nodes) }),
  onEdgesChange: (changes) => set({ edges: applyEdgeChanges(changes, get().edges) }),
  setNodes: (nodes) => set({ nodes }),
  setEdges: (edges) => set({ edges }),
  // CRITICAL: create NEW object to trigger ReactFlow re-render
  updateNodeData: (nodeId, data) => set({
    nodes: get().nodes.map((n) =>
      n.id === nodeId ? { ...n, data: { ...n.data, ...data } } : n
    ),
  }),
}));
```

### Custom Agent Node

```typescript
import { Handle, Position, type NodeProps } from '@xyflow/react';

const STATUS_COLORS = {
  pending: '#9CA3AF', scheduled: '#60A5FA', running: '#3B82F6',
  completed: '#10B981', failed: '#EF4444', retrying: '#F59E0B',
  paused: '#8B5CF6', skipped: '#D1D5DB', mutated: '#EAB308',
};

function AgentNode({ data }: NodeProps) {
  return (
    <div className={`agent-node status-${data.status}`}
         style={{ borderColor: STATUS_COLORS[data.status] }}>
      <Handle type="target" position={Position.Top} />
      <div className="node-header">
        <span className={`status-dot ${data.status}`} />
        <span>{data.role}</span>
      </div>
      {data.skills && (
        <div className="node-skills">
          {data.skills.map((s: string) => <span key={s} className="badge">{s}</span>)}
        </div>
      )}
      {data.status === 'completed' && data.output?.summary && (
        <div className="node-output">{data.output.summary.slice(0, 60)}...</div>
      )}
      {data.metrics?.cost_usd > 0 && (
        <div className="node-meta">${data.metrics.cost_usd.toFixed(3)}</div>
      )}
      <Handle type="source" position={Position.Bottom} />
    </div>
  );
}

// MUST define outside component (or useMemo) to avoid re-registration
const nodeTypes = { agentNode: AgentNode };
```

### ELKjs Auto-Layout Hook

```typescript
import ELK from 'elkjs/lib/elk.bundled.js';
import { useCallback } from 'react';
import { useReactFlow } from '@xyflow/react';

const elk = new ELK();

export function useAutoLayout() {
  const { fitView } = useReactFlow();

  return useCallback(async (nodes: Node[], edges: Edge[], direction = 'DOWN') => {
    const isHorizontal = direction === 'RIGHT';
    const layouted = await elk.layout({
      id: 'root',
      layoutOptions: {
        'elk.algorithm': 'layered',
        'elk.direction': direction,
        'elk.spacing.nodeNode': '80',
        'elk.layered.spacing.nodeNodeBetweenLayers': '100',
        'elk.edgeRouting': 'ORTHOGONAL',
      },
      children: nodes.map((n) => ({
        ...n,
        targetPosition: isHorizontal ? 'left' : 'top',
        sourcePosition: isHorizontal ? 'right' : 'bottom',
        width: n.measured?.width ?? 220,
        height: n.measured?.height ?? 120,
      })),
      edges,
    });
    const result = layouted.children!.map((elkN) => ({
      ...nodes.find((n) => n.id === elkN.id)!,
      position: { x: elkN.x!, y: elkN.y! },
    }));
    window.requestAnimationFrame(() => fitView());
    return result;
  }, [fitView]);
}
```

### Dashboard Assembly

```typescript
import { ReactFlow, ReactFlowProvider, Panel } from '@xyflow/react';
import '@xyflow/react/dist/style.css';

function DAGDashboard({ dagId }: { dagId: string }) {
  const { nodes, edges, onNodesChange, onEdgesChange } = useDAGStore();
  const layout = useAutoLayout();

  // WebSocket → Zustand (see websocket-streaming skill)
  useDAGStream(dagId);

  return (
    <ReactFlow nodes={nodes} edges={edges} nodeTypes={nodeTypes}
      onNodesChange={onNodesChange} onEdgesChange={onEdgesChange} fitView>
      <Panel position="top-right">
        <button onClick={() => layout(nodes, edges, 'DOWN')}>↓ Vertical</button>
        <button onClick={() => layout(nodes, edges, 'RIGHT')}>→ Horizontal</button>
      </Panel>
    </ReactFlow>
  );
}

export default function DAGPage({ dagId }: { dagId: string }) {
  return <ReactFlowProvider><DAGDashboard dagId={dagId} /></ReactFlowProvider>;
}
```

---

## v12 Gotchas

| Pitfall | Fix |
|---------|-----|
| `nodeTypes` defined inside component → infinite re-render | Define OUTSIDE component or wrap in `useMemo` |
| State update doesn't trigger re-render | Must create NEW node object: `{ ...node, data: { ...node.data, ...update } }` |
| `xPos`/`yPos` in custom node → undefined | Use `positionAbsoluteX`/`positionAbsoluteY` (v12 rename) |
| `nodeInternals` → undefined | Use `nodeLookup` (v12 rename) |
| ELK layout ignores node size | Pass `node.measured?.width` and `height` explicitly |
| `fitView` fires before DOM paint | Wrap in `requestAnimationFrame(() => fitView())` |
| Interactive elements drag the node | Add `className="nodrag"` to inputs, buttons, selects |

---

## Anti-Patterns

### Canvas Rendering for Debugging
**Wrong**: Using canvas-based libraries (GoJS) where you can't inspect nodes in dev tools.
**Right**: ReactFlow renders SVG + HTML. Every node is inspectable in React DevTools and the DOM.

### Re-running Layout on Every State Update
**Wrong**: Calling ELK layout every time a node's status changes (expensive, causes visual jitter).
**Right**: Only re-layout when topology changes (add/remove node/edge). Status color changes are just data updates — no layout needed.

### Monolithic Node Component
**Wrong**: One giant node component handling all node types.
**Right**: Register separate node types: `agentNode`, `humanGateNode`, `pluripotentNode`. Each is a focused React component.

© curiositech · MIT · curiositech/some_claude_skills

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

Все скиллы по теме «Фронтенд и UI» →
dag-map Son Nguyen Скилл dag-map рисует граф многоагентной оркестрации сессии: кто родитель, кто дети, на какой глубине и сколько веток. Нужен, чтобы понять, как устроена структура агентов в текущей сессии. CX Codex +1 ★ 1 198звёзд репо reactflow-fundamentals TheBushidoCollective Скилл reactflow-fundamentals помогает создавать блок-схемы, редакторы пайплайнов и графы на React Flow. Подсказывает агенту готовые структуры узлов, рёбер и элементов управления. CX Codex +1 138установок reactflow-custom-nodes TheBushidoCollective Скилл reactflow-custom-nodes учит агента создавать кастомные узлы, рёбра и хендлы для React Flow: настраиваемые компоненты, изменяемые размеры, тулбары. CX Codex +1 112установок frontend-state-management aj-geddes Скилл frontend-state-management для работы с состоянием фронтенда: подсказывает, как организовать Redux, MobX, Zustand или Context API в приложении. CX Codex +1 487установок state-management akillness Скилл state-management помогает решить, кому принадлежит состояние в React-приложении, и выбрать самый узкий подходящий инструмент вместо спора о библиотеках. CX Codex +1 367установок form-wizard-builder patricio0312rev Скилл form-wizard-builder собирает многошаговые формы: схемы валидации, шаги, общее состояние, индикатор прогресса и шаг проверки перед отправкой. CX Codex +1 344установок

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

Весь набор →
hr-network-analyst Скилл hr-network-analyst строит графы профессиональных связей и находит неявных коннекторов по метрикам центральности. Помогает подбирать людей для рекомендаций и выявлять структурные дыры в профсообществах. CX Codex +1 184установок oauth-oidc-implementer Скилл oauth-oidc-implementer помогает настроить авторизацию по протоколам OAuth 2.0 и OIDC, вход через соцсети и безопасную работу с JWT в серверных или клиентских приложениях. CX Codex +1 183установок web-cloud-designer Скилл web-cloud-designer для Claude Code создаёт облачные эффекты для веб-страниц с помощью SVG-фильтров и CSS-анимации. Добавляет атмосферный фон, небо или параллакс-сцену. CX Codex +1 183установок windows-3-1-web-designer Скилл windows-3-1-web-designer для Claude Code генерирует веб-приложения в эстетике Windows 3.1: с тёмно-синими заголовками, фасками и Program Manager вместо навигации. Создаёт ретро-дашборды, документацию и чат-интерфейсы в духе Cue Cards. CX Codex +1 183установок claude-ecosystem-promoter Скилл claude-ecosystem-promoter помогает продвигать MCP-серверы, скиллы, плагины и субагентов через реестры, сообщества и контент. CX Codex +1 182установок design-system-generator Скилл design-system-generator для Claude Code сопоставляет описание интерфейса с визуальными трендами. Он включается при запросах о дизайн-системе, стиле или рекомендациях по тренду. CX Codex +1 182установок knot-theory-educator Скилл knot-theory-educator объясняет теорию кос и узлов через наглядные диаграммы, карточки и пошаговые анимации. CX Codex +1 182установок senior-coding-interview Скилл senior-coding-interview готовит к собеседованиям уровня L6+: помогает разбирать небольшие системы, проговаривать решения и отвечать на итерационные уточнения. CX Codex +1 181установок

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

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