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

extract-tikz — скилл для Claude Code: TikZ в SVG из Beamer

Скилл extract-tikz для Claude Code выдёргивает TikZ-диаграммы из Beamer-исходника, компилирует в PDF и конвертирует в SVG с нумерацией с нуля. Синхронизирует слайды с Quarto.

MIT ★ 1 729 обновлён 2026-09-27

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

Что делает extract-tikz

Скилл разбирает \begin{tikzpicture} в .tex-файле лекции и превращает каждый блок в отдельный SVG. Процесс жёсткий: сначала сверка с исходником, потом превентивная проверка правил, затем xelatex и pdf2svg.

Перед компиляцией скилл запускает scripts/check-tikz-prevention.py и останавливается, если масштабирование или подписи рёбер нарушают правила P3 и P4. Требуется Python 3, а для компиляции нужен xelatex и pdf2svg в системе.

Финальный этап — вызов субагента tikz-reviewer, который выносит вердикт APPROVED, NEEDS REVISION или REJECTED. Если не APPROVED, скилл возвращает правки в Beamer и повторяет цикл, максимум пять раз. Без этого цикла SVG уходят в прод с пересечениями подписей.

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

  • выдрать TikZ-блоки из Beamer-лекции в отдельный файл
  • собрать многостраничный PDF с диаграммами
  • конвертировать каждую страницу PDF в SVG
  • проверить масштабирование и направления подписей до компиляции
  • прогнать диаграммы через tikz-reviewer

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

  • Собери SVG для Lecture2 через extract-tikz
  • TikZ-блоки в lecture2.tex поменялись, пересобери диаграммы
  • Проверь extract_tikz.tex на нарушения P3/P4

Как установить extract-tikz

1Через Skills CLI (Vercel)

npx skills add pedrohcgs/claude-code-my-workflow --skill extract-tikz -a claude-code

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

~/.claude/skills/extract-tikz/SKILL.md

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

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

Вопросы об extract-tikz

Как установить extract-tikz в Claude Code?

Выполните npx skills add pedrohcgs/claude-code-my-workflow --skill extract-tikz -a claude-code. Скилл появится в ~/.claude/skills/extract-tikz/SKILL.md.

Что делает extract-tikz?

Извлекает TikZ-диаграммы из Beamer-исходника, компилирует их в многостраничный PDF, конвертирует страницы в SVG с 0-based индексацией и гоняет через субагента tikz-reviewer для проверки пересечений и ошибок.

Что нужно для работы скилла?

Нужны xelatex, pdf2svg и Python 3. Превентивная проверка запускается скриптом scripts/check-tikz-prevention.py и требует, чтобы блоки TikZ соответствовали правилам P3 и P4.

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

SKILL.md · MIT
---
name: extract-tikz
description: Extract TikZ diagrams from Beamer `.tex` source, compile each to a standalone PDF, and convert to SVG with 0-based indexing. Use when user says "extract the tikz", "regenerate the diagrams", "rebuild the SVGs", "sync tikz to quarto", or after editing TikZ blocks in a Beamer deck that also has a Quarto mirror.
argument-hint: "[LectureN, e.g., Lecture2]"
allowed-tools: ["Read", "Bash", "Glob", "Agent", "Task"]
---

# Extract TikZ Diagrams to SVG

Extract TikZ diagrams from the Beamer source, compile to multi-page PDF, and convert each page to SVG for use in Quarto slides.

> **Creating a brand-new diagram instead of extracting?** Use [`/new-diagram`](../new-diagram/SKILL.md) — it scaffolds from `templates/tikz-snippets/` with the prevention rules pre-applied.

## Steps

### Step 0: Freshness Check (MANDATORY)

**Before compiling, verify that `extract_tikz.tex` matches the current Beamer source.**

1. Find the Beamer source: `ls Slides/$ARGUMENTS*.tex`
2. Extract all `\begin{tikzpicture}` blocks from Beamer
3. Compare with `Figures/$ARGUMENTS/extract_tikz.tex`
4. If ANY difference exists: update extract_tikz.tex from the Beamer source
5. If extract_tikz.tex doesn't exist: create it from scratch

### Step 1: Prevention pre-check (MANDATORY — halt on violation)

Before compiling, verify every `\begin{tikzpicture}` block in `Figures/$ARGUMENTS/extract_tikz.tex` satisfies the prevention rules in [`.claude/rules/tikz-prevention.md`](../../rules/tikz-prevention.md). The pre-check is a small Python script shared with `/new-diagram` so both skills enforce identical behavior:

```bash
python3 scripts/check-tikz-prevention.py "Figures/$ARGUMENTS/extract_tikz.tex"
```

What it checks:

- **P3 — `scale=X` without node scaling.** Bare `scale=` shrinks coordinates but not text. Allowed forms: `scale=X, every node/.style={scale=X}` or `scale=X, transform shape`. The checker parses the full `\begin{tikzpicture}[...]` options block even when it spans multiple lines.
- **P4 — Directional keyword on edge labels.** Every edge label (`node` inside a `\draw`) must carry `above`, `below`, `left`, `right`, or a compound (e.g. `above left`). `midway` alone is a path position, not a direction. The checker scans the full `\draw ...;` statement so `\draw` on one line and `node[...]{...}` on the next line are still linked.

Note what the pre-check does NOT enforce: P1 (boxed-node explicit dimensions) and P2 (coordinate-map comment) are structural and get flagged by `tikz-reviewer` in Step 8, not here.

Exit codes: `0` = all files pass, `1` = one or more P3/P4 violations (stderr lists file, line, snippet, rule), `2` = usage error.

If exit is non-zero: halt, report the offending lines, and ask the user to fix the Beamer source (single source of truth). Do NOT compile.

### Step 2: Navigate to the lecture's Figures directory
```bash
cd Figures/$ARGUMENTS
```

### Step 3: Compile the extract_tikz.tex file
```bash
TEXINPUTS=../../Preambles:$TEXINPUTS xelatex -interaction=nonstopmode extract_tikz.tex
```

### Step 4: Count the number of pages
```bash
pdfinfo extract_tikz.pdf | grep "Pages:"
```

### Step 5: Convert each page to SVG using 0-BASED INDEXING

**CRITICAL: PDF pages are 1-indexed, but output SVG files are 0-indexed!**

```bash
PAGES=$(pdfinfo extract_tikz.pdf | grep "Pages:" | awk '{print $2}')
for i in $(seq 1 $PAGES); do
  idx=$(printf "%02d" $((i-1)))
  pdf2svg extract_tikz.pdf tikz_exact_$idx.svg $i
done
```

### Step 6: Sync to docs/ for deployment
```bash
cd ../..
./scripts/sync_to_docs.sh $ARGUMENTS
```

### Step 7: Verify SVG files
- Read 2-3 SVG files to confirm they contain valid SVG markup
- Confirm file sizes are reasonable (not 0 bytes)

### Step 8: Visual Quality Review (tikz-reviewer)

Spawn the **tikz-reviewer** agent (via the `Agent` tool with `subagent_type=tikz-reviewer`) on the TikZ source blocks to catch label overlaps, geometric errors, and visual inconsistencies. The reviewer cites specific passes and formulas from [`.claude/rules/tikz-measurement.md`](../../rules/tikz-measurement.md). If it returns **NEEDS REVISION** or **REJECTED**, loop:

1. Apply the recommended fixes to the Beamer `.tex` source (single source of truth).
2. Re-copy the updated block to `extract_tikz.tex`.
3. Re-run the prevention pre-check (Step 1) and compile.
4. Regenerate SVGs, re-sync.
5. Re-invoke tikz-reviewer.

Stop when tikz-reviewer returns **APPROVED** (max 5 rounds).

### Step 9: Report results

## Source of Truth Reminder
TikZ diagrams MUST be edited in the Beamer `.tex` file first, then copied verbatim to `extract_tikz.tex`. See `.claude/rules/single-source-of-truth.md`.

© pedrohcgs · MIT · pedrohcgs/claude-code-my-workflow

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

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
tikz-scientific-figures cjh-solver Скилл tikz-scientific-figures для Claude Code рисует рисунки для статьи или отчёта на TikZ и PGFPlots и отдаёт SVG с PNG. Один рисунок — один standalone-файл .tex, и он остаётся редактируемым. CX Codex +1 ★ 108звёзд репо tikz-flowchart yzlnew Скилл tikz-flowchart помогает генерировать блок-схемы и архитектурные диаграммы на LaTeX TikZ с готовыми темами оформления. CX Codex +1 ★ 158звёзд репо hf-architecture-tikz yzlnew Скилл hf-architecture-tikz генерирует вертикальные схемы архитектуры декодерных LLM из HuggingFace в формате TikZ с точными формулами и числом параметров. CX Codex +1 ★ 158звёзд репо explorable-beamer claesbackman Скилл explorable-beamer собирает PDF-презентации Beamer в explorable-стиле Ники Кейс: одна мысль на кадр, живой пример, раскрывающиеся стадии TikZ и appendix с ответвлениями. CX Codex +1 ★ 579звёзд репо latex-posters K-Dense-AI Скилл latex-posters собирает научные постеры через три LaTeX-пакета, компилирует PDF и проверяет шрифты перед отправкой в типографию. CX Codex +1 2 300установок latex-document-skill ndpvt-web Скилл latex-document-skill верстает резюме, научные статьи, презентации и формы в LaTeX, собирает их в PDF через скрипты и отдаёт превью страниц в PNG. CX Codex +1 608установок

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

Весь набор →
issues Скилл превращает замечания и найденные проблемы в задачи GitHub Issues, показывает открытые задачи и сохраняет итог исправления. Нужен GitHub CLI. CX Codex +1 ★ 1 729звёзд репо interview-me Скилл interview-me проводит многошаговое интервью и превращает сырую идею исследования в структурированную спецификацию: вопрос, гипотезы, идентификация, данные, стратегия. CX Codex +1 ★ 1 729звёзд репо humanize Скилл humanize находит штампы и речевые маркеры нейросетей в текстах LaTeX, Quarto и Markdown. Создаёт отчёт с проблемными местами перед подачей статьи в журнал. CX Codex +1 ★ 1 729звёзд репо grant-proposal Скилл grant-proposal для Claude Code собирает черновик исследовательской грантовой заявки из спецификации проекта. Готовит заявки для NSF, NIH, ERC и фондов. CX Codex +1 ★ 1 729звёзд репо disclosure-check Скилл disclosure-check для Claude Code проверяет таблицы, графики и логи на утечки приватных данных и нарушения правил раскрытия статистики перед выгрузкой из защищённых контуров. CX Codex +1 ★ 1 729звёзд репо differential-audit Скилл differential-audit для Claude Code сравнивает две реализации одной логики и выявляет расхождения в результатах, предупреждениях и обработке ошибок. Проверяет перенос кода между языками, рефакторинг и воспроизведение исследований. CX Codex +1 ★ 1 729звёзд репо diagnose Скилл diagnose для Claude Code ведёт от воспроизведения бага к минимальному примеру, гипотезам и починке. Разбирает регрессии с неверным числом и падения скриптов. CX Codex +1 ★ 1 729звёзд репо devils-advocate Скилл devils-advocate проверяет лекции и слайды с позиции строгого критика. Скилл задаёт от пяти до семи неудобных вопросов о структуре материала и понятности обозначений. CX Codex +1 ★ 1 729звёзд репо

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

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