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

flow-next-visual — скилл для Claude Code: что делает и как установить

Скилл flow-next-visual превращает спецификацию, задачу, diff или тему разговора в компактную Markdown-схему. Запустите его, когда длинное объяснение удобнее просмотреть глазами.

MIT ★ 730 обновлён 2026-10-29

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add gmickel/flow-next
/plugin install flow-next@flow-next
Открыть на GitHub

Что делает flow-next-visual

flow-next-visual собирает краткий визуальный конспект в чате: дерево задач, структуру файлов, схему компонентов или вызовов. Для спецификации он показывает, что планируется выпустить, как задачи зависят друг от друга и какие требования пока не покрыты. Для diff — изменённые файлы и структуру кода, если её можно подтвердить по изменениям.

Скилл читает состояние проекта и отвечает в чате. Он не меняет файлы, состояние flow или историю Git. Схемы строятся по данным спецификации, задач и git diff --name-status; в свободном режиме — по указанному тексту. Если flowctl недоступен или проект не является Git-репозиторием, скилл переходит к пересказу темы без этих данных.

Вызовите /flow-next:visual с ID спецификации, ID задачи или диапазоном Git либо попросите визуально изложить тему. Для режима diff без диапазона нужны Git и ветка по умолчанию; неподтверждённые связи скилл не должен дорисовывать. Это значит, что обзор структуры будет кратким, если сами изменения её не показывают.

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

  • Свести план спецификации к дереву задач и файлов
  • Проверить, какие требования покрывают задачи
  • Показать состав изменений в Git diff
  • Пересказать длинную тему компактной схемой

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

  • Покажи спецификацию fn-12-add-oauth в виде компактной схемы.
  • Разбери задачу fn-12-add-oauth.1: что она создаёт и от чего зависит?
  • Визуально покажи изменения в диапазоне main..HEAD.

Как установить flow-next-visual

1Через маркетплейс плагинов

/plugin marketplace add gmickel/flow-next
/plugin install flow-next@flow-next

Команда ставит плагин flow-next целиком, со всеми его скиллами

2Через Skills CLI (Vercel)

npx skills add gmickel/flow-next --skill flow-next-visual -a claude-code

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

~/.claude/skills/flow-next-visual/SKILL.md

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

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

Вопросы о flow-next-visual

Как установить flow-next-visual в Claude Code?

В Claude Code добавьте маркетплейс командой /plugin marketplace add gmickel/flow-next, затем установите плагин: /plugin install flow-next@flow-next.

Что делает flow-next-visual?

Он преобразует спецификацию, задачу, Git diff или текущую тему в компактный Markdown-конспект с деревьями и короткими схемами. Результат появляется в чате.

Меняет ли скилл файлы проекта?

Нет. Он читает данные и формирует ответ, не записывая файлы и не меняя состояние flow или Git.

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

SKILL.md · MIT
---
name: flow-next-visual
description: "Restate a spec, a task, a diff, or the current topic visually as a compact markdown digest. Use when asked to 'show me', 'explain this visually', 'restate that', 'digest the plan', 'walk me through the spec', 'walk me through the tasks', 'walk me through the diff', or when the output is too much text and a shape would land faster. Triggers on /flow-next:visual with an optional spec id, task id, git range, or free-form topic."
user-invocable: false
allowed-tools: Read, Bash, Grep, Glob
---

# Visual — human-first markdown digest

Restate one thing visually, in compact markdown, on one screen. The structure IS the output: the reader scans the shape, spots the wrong thing, and drills into only that file instead of reading everything to find out whether anything is wrong.

**Output contract:** compact markdown visuals rendered in chat — fenced text/diff/code blocks and tiny tables. Never images, never HTML files, never a written artifact. Everything here renders natively in the terminal, in chat, and on every forge: ```diff fences color for free, ```text is monospace everywhere, ```ts gets highlighting for free. There is no rendering machinery — the shapes below are the whole product.

**Read-only.** This skill reads state and responds. It never writes files, never mutates flow state, never commits, never runs a workflow. (If the user asks to save a digest, that is an ordinary Write with ordinary consent — not a mode of this skill.)

## Preamble

flowctl is bundled with the plugin (not on PATH). Define once; subsequent blocks use `$FLOWCTL`:

```bash
FLOWCTL="${DROID_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/scripts/flowctl"
[ -x "$FLOWCTL" ] || FLOWCTL="<plugin-root>/scripts/flowctl"   # <plugin-root> = the directory two levels above this skill's SKILL.md file (the harness gave you that file's absolute path when the skill loaded); substitute it literally
[ -x "$FLOWCTL" ] || FLOWCTL=".flow/bin/flowctl"
```

## Input

Arguments: `$ARGUMENTS` — optional. One of:

- **Spec id** (`fn-12-add-oauth`) → spec digest
- **Task id** (`fn-12-add-oauth.1`) → task digest
- **Git range** (`main..HEAD`, `abc123..def456`, or the bare word `diff`) → diff digest
- **Nothing, or free-form text** → ad-hoc restate of the current topic (or of the text pointed at)

## Digest modes

### Spec digest (post-plan) — the primary mode

Read `$FLOWCTL show <spec-id> --json`, the spec markdown (`$FLOWCTL cat <spec-id>`), and every task file (`$FLOWCTL cat <task-id>`). Emit these six elements, in order, on one screen:

1. **Thesis** — 1-2 sentences: what ships and why.
2. **Task tree** — indented text tree in dependency order, parallel groups adjacent; one line per task: id, short title, the one thing it produces.
3. **Planned file-layout diff** — shallow tree with `+` (new) / `~` (changed) per file or dir, one-line responsibility, owning task id annotated, so the reviewer sees where the change lands and who owns it.
4. **Shape sketch** — the new/changed types, signatures, config keys, or command surfaces the tasks will create (shape 6), when the plan implies any. Skip when it implies none.
5. **R-ID coverage line** — one compact line or tiny table from the tasks' declared `satisfies` arrays, which live in each task file's frontmatter (`$FLOWCTL cat <task-id>`), not in `show --json`: `R1 -> t1 · R2 -> t2,t3 · R5 -> UNCOVERED`. Uncovered and undeclared jump out instead of needing cross-referencing.
6. **Boundaries** — IS / IS-NOT, one line each side.

### Spec digest (pre-plan)

No tasks yet: thesis, proposed shape, edge cases as one-liners, boundaries. No task tree, no coverage line — there is nothing to derive them from, and inventing them is the failure mode this mode exists to avoid.

### Task digest

One task: what it produces (shape sketch or file-layout diff), its position in the dependency tree, and its acceptance restated as 1-3 predicates.

### Diff digest

Input is a git range; on a branch with no range given, default to the merge base with the default branch (`git merge-base origin/HEAD HEAD` or the repo's default branch). Emit a file-layout diff with paths from `git diff --name-status` (rename-aware path identity — `--stat` prints `{old => new}` presentation labels, not paths) and churn from `git diff --stat`, plus a call-tree or component-tree sketch of the load-bearing structural change — when the diff carries one. A docs/config-only range with no real call or component relationship gets the grounded file-layout diff alone; never invent structure to satisfy the shape. For orienting a reader before they read the real diff. Empty range: say so in one line and stop — never fabricate a sketch.

### Ad-hoc restate

No flow id: restate the current conversation topic, or the text the user points at, using the vocabulary. This is the "too much text — show me" mode and the natural-language entry point. Needs no flowctl and no git.

## Grounding (hallucination guardrails)

- Every path in a file tree comes from a task file, the spec, or `git diff --name-status` — never invented. (`--stat` is for churn numbers only; its rename labels `{old => new}` are presentation strings, not paths.)
- Every edge in a call tree traces to real code read in this session or to a real task dependency. In ad-hoc mode, paths and relationships explicitly present in the supplied topic text also count as grounded — restating them is the job; adding ones the text does not support is not.
- Coverage lines come from the tasks' declared `satisfies` frontmatter (read with `$FLOWCTL cat <task-id>`) checked against the spec's R-IDs, not from re-narrated prose.
- No embellishment nodes "for clarity". When in doubt: **fewer nodes, more honest.**
- Nothing readable → say what was unreadable in one line, digest what is readable. A digest that quietly invents the missing half is worse than a short one.

## Degradation

- No tasks yet → pre-plan spec digest.
- No spec (or the id resolves to nothing) → diff digest if a range applies, else ad-hoc restate.
- No flowctl, no flow install, or not a git repo → ad-hoc restate, with a one-line notice of what was unavailable. The vocabulary needs neither.

## Shape vocabulary

Pick the **smallest** view that makes the key point clear. Place each visual **next to the short text it supports** — the visual supplements a one-or-two-sentence plain statement, never replaces it. Use **one or a few** shapes, never all of them. Skip preamble; prose stays brief and load-bearing.

**1. Pseudocode** — logic or an algorithm:

```text
on(message)
  if seen(message.id)
    drop
  enqueue(message)
  schedule flush
```

**2. Call tree** (indented text) — runtime control flow, orchestration, backend-shaped problems:

```text
startMission
  resolveFleet
    claimSeat
    openSession
  streamEvents
```

**3. Component tree** — UI structure, keeping ONLY the state hooks and module boundaries that matter:

```tsx
<MissionBoard> (apps/cockpit/src/routes/mission.tsx)
  useFleetEvents()
  <SeatGrid>
    <SeatCard> (packages/ui)
```

**4. Shallow file tree** — "where does this live" / scoping a refactor; one line of responsibility per entry:

```text
src/
|-- ingest/        # tails source feeds
|-- index/         # owns the search index
`-- query/         # answers searches
```

**5. Diff-fenced structural sketch** — the standout shape: diff syntax applied to a SHAPE (call tree, file tree, component tree, pseudocode), used when the point is what changes and the surrounding shape already exists. Match the diff shape to the topic.

File-layout change:

```diff
 src/
 |-- ingest/
+|   `-- dedupe.ts        # drops repeated events
 |-- index/
-`-- query.ts
+`-- query/
+    |-- parser.ts
+    `-- ranker.ts
```

Component-tree change:

```diff
 <MissionBoard>
   useFleetEvents()
   <SeatGrid>
+    <SeatFilter />
   <EventFeed>
+    <RetryBanner />
```

Call-tree change:

```diff
 startMission
   resolveFleet
     claimSeat
+    verifyAuth
     openSession
-  streamEvents
+  streamEvents
+    replayBacklog
```

State/control-flow change:

```diff
 on(message)
-  enqueue(message)
+  if seen(message.id)
+    drop
+  enqueue(message)
+  schedule flush
```

**6. Types and signatures** — the shape of code before any of it exists (the thing plan prose buries):

```ts
interface Seat {
  id: SeatId
  missionId: MissionId | null
}

assignSeat(seats: Seat[], policy: Policy) -> SeatId | null
```

**7. Compact table** — short enumerable facts only (R-ID coverage, per-task file ownership). Explanations live in the surrounding prose, never in cells.

**8. Mermaid — LAST resort.** Only when interaction or sequence genuinely needs it (renders graphically on forges, degrades to source in terminals); when warranted, sequence and state diagrams are the two forms that earn their keep. A text shape that carries the same point wins every time. Use valid identifiers, quote labels containing punctuation, and check syntax before emitting.

**Whole-block rule.** Show a complete block instead of a diff when most of it is new, when omitted context would hide ownership or order, or when the reader needs a copyable target shape.

**Trimming rule.** Within the chosen shape, keep ONLY the calls, files, props, states, and boundaries needed to answer the current question — everything else is left out, even when true.

## Forbidden

- Writing any file, mutating flow state, committing, or running another workflow.
- Emitting images or HTML — chat markdown only.
- Inventing a path, an edge, or a coverage claim that no read state supports.
- Emitting mermaid when a text shape would have carried the point.
- Using every shape because they exist — one or a few, chosen for the question.
- Padding with preamble, restating the spec in prose, or exceeding one screen.

© Gordon Mickel · MIT · gmickel/flow-next

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

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
visual-pr humanlayer Скилл visual-pr автоматизирует описание pull request: читает дифф, собирает контекст и оформляет PR по шаблону так, чтобы ревьюеру было понятно, зачем нужна перемена и как она устроена. CX Codex +1 4 500установок visual-recap BuilderIO Скилл visual-recap превращает PR, ветку или git diff в интерактивный визуальный план со схемами, картой файлов и аннотированным кодом. Пригодится при ревью крупных изменений. CX Codex +1 1 000установок pr-flow modelcontextprotocol Скилл pr-flow проводит задачу от issue до пул-реквеста и закрывает её после мержа: ветка, DCO-подпись, гейт, ревью Copilot. CX Codex +1 ★ 92 149звёзд репо visual-explainer vercel-labs Скилл visual-explainer превращает баги, PR и фичи в пошаговые инфографики с диаграммами, подсвеченным кодом и чётким разделением на «было» и «стало». CX Codex +1 235установок git-flow-manager davila7 Субагент git-flow-manager для Claude Code управляет Git Flow: создаёт ветки по схеме, проверяет конфликты при слиянии, ставит теги и открывает pull request в проектах со строгой схемой ветвления. CX Codex 3 127установок flow-status davila7 Команда flow-status показывает, в какой ветке Git Flow вы находитесь, насколько она разошлась с remote и куда потом сольётся. CX Codex +1 1 514установок

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

Весь набор →
flow-next-prime Скилл flow-next-prime оценивает готовность кодовой базы к работе ИИ-агентов и эксплуатации: проверяет, выполняются ли команды, и выдаёт вердикт с приоритетными следующими шагами. CX Codex +1 ★ 730звёзд репо repo-scout Субагент repo-scout сканирует репозиторий и находит готовые паттерны, конвенции и смежный код перед тем, как агент начнёт писать новую фичу. CX Codex ★ 730звёзд репо flow-next-features Скилл flow-next-features для Claude Code создаёт и обновляет карту пользовательских функций в .flow/features/. QA и drive используют её, чтобы повторно находить маршруты к функциям. CX Codex +1 ★ 730звёзд репо flow-next-sync Скилл flow-next-sync обновляет спеки нижестоящих задач, когда код ушёл вперёд: скилл вручную запускает plan-sync и правит todo и blocked задачи. CX Codex +1 ★ 730звёзд репо flow-next-memory-migrate Скилл flow-next-memory-migrate переносит плоские markdown-файлы заметок в структурированную схему памяти YAML через инструмент flowctl. CX Codex +1 ★ 730звёзд репо flow-next-flow Скилл flow-next-flow для Claude Code и Codex, который маршрутизирует работу между этапами: захват, уточнение, планирование, разработка, QA, создание PR и слияние. Запускается автоматически или в режиме --auto для беспилотных прогонов. CX Codex +1 ★ 730звёзд репо flow-next-chart Скилл flow-next-chart помогает разложить крупную неясную идею на решения и подготовить краткий бриф для захвата в спецификации. Он пригодится, когда сначала нужно понять, что именно предстоит решить. CX Codex +1 ★ 730звёзд репо flow-next-strategy Скилл flow-next-strategy создаёт и обновляет STRATEGY.md в корне репозитория: целевая проблема, подход, аудитория, метрики и треки работы. CX Codex +1 ★ 730звёзд репо

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

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