скилл CX Codex

deploy · pedrohcgs — скилл для Claude Code: публикация слайдов

Q: Как установить deploy в Claude Code?

Выполните `npx skills add pedrohcgs/claude-code-my-workflow --skill deploy -a claude-code`. Файл скилла устанавливается по пути `~/.claude/skills/deploy/SKILL.md`.

Q: Что делает deploy?

Рендерит слайды `.qmd` и синхронизирует HTML, ресурсы, PDF, изображения и R-скрипты с каталогами `docs/`. Затем проверяет опубликованные файлы и предлагает открыть слайды в браузере.

Q: Можно ли запустить deploy только для одной лекции?

Да. Передайте имя вроде `Lecture4`; без аргумента скрипт синхронизирует все лекции. Для локального рендера без синхронизации используйте `quarto render`.

Скилл собирает слайды Quarto в HTML и синхронизирует файлы с docs/ для GitHub Pages. Запускайте его, когда нужно опубликовать лекцию.

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓

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

Открыть на GitHub

Что делает deploy

Скилл вызывает ./scripts/sync_to_docs.sh: с аргументом LectureN он синхронизирует выбранную лекцию, без аргумента — все лекции. Скрипт рендерит .qmd из Quarto/, пропускает файлы с *_backup* и копирует результат в docs/slides/. Туда же попадают PDF из Slides/, а изображения из Figures/ синхронизируются с docs/Figures/.

После синхронизации скилл проверяет HTML, папки ресурсов _files/, R-скрипты и, если они используются, интерактивные графики и SVG. Для визуальной проверки предлагает открыть слайды в браузере. Он готовит файлы в docs/, но сам не отправляет их в GitHub Pages; публикацию нужно выполнить отдельно.

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

собрать HTML-слайды Quarto для публикации
синхронизировать выбранную лекцию с docs/
скопировать PDF и ресурсы RevealJS рядом со слайдами
проверить, что R-скрипты и изображения попали в папки публикации
открыть собранные слайды в браузере для проверки отображения

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

Опубликуй лекцию Lecture4 и проверь файлы в docs/.
Собери все слайды Quarto для GitHub Pages и проверь их в браузере.
После правок в Quarto/ синхронизируй слайды с docs/.

Как установить deploy

1Через Skills CLI (Vercel)

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

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

~/.claude/skills/deploy/SKILL.md

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

1Через Skills CLI (Vercel)

npx skills add pedrohcgs/claude-code-my-workflow --skill deploy -a codex

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

.agents/skills/deploy/SKILL.md

Для всех проектов — ~/.agents/skills/

1Через Skills CLI (Vercel)

npx skills add pedrohcgs/claude-code-my-workflow --skill deploy -a cursor

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

.cursor/skills/deploy/SKILL.md

Cursor читает и .agents/skills/, и .claude/skills/

1GitHub CLI

gh skill install pedrohcgs/claude-code-my-workflow deploy

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

.github/skills/deploy/SKILL.md

1Через Skills CLI (Vercel)

npx skills add pedrohcgs/claude-code-my-workflow --skill deploy -a gemini-cli

2Командой платформы

gemini skills install https://github.com/pedrohcgs/claude-code-my-workflow --path .claude/skills/deploy

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

.devin/skills/deploy/SKILL.md

Старый путь .windsurf/skills/ тоже читается

Через Skills CLI (Vercel)

npx skills add pedrohcgs/claude-code-my-workflow --skill deploy -a opencode

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

Вопросы о deploy

Как установить deploy в Claude Code?

Выполните npx skills add pedrohcgs/claude-code-my-workflow --skill deploy -a claude-code. Файл скилла устанавливается по пути ~/.claude/skills/deploy/SKILL.md.

Что делает deploy?

Рендерит слайды .qmd и синхронизирует HTML, ресурсы, PDF, изображения и R-скрипты с каталогами docs/. Затем проверяет опубликованные файлы и предлагает открыть слайды в браузере.

Можно ли запустить deploy только для одной лекции?

Да. Передайте имя вроде Lecture4; без аргумента скрипт синхронизирует все лекции. Для локального рендера без синхронизации используйте quarto render.

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

SKILL.md · MIT

---
name: deploy
description: Render Quarto `.qmd` slides to HTML and sync to `docs/` for GitHub Pages. Use when user says "deploy", "publish the slides", "ship to pages", "push the lecture live", "render and publish", or after Quarto edits that need to go public. NOT for local Quarto render only — use `quarto render` directly for that.
argument-hint: "[LectureN or 'all']"
allowed-tools: ["Read", "Bash"]
---

# Deploy Slides to GitHub Pages

Render Quarto slides and sync all files to `docs/` for GitHub Pages deployment.

## Steps

1. **Run the sync script:**
   - If `$ARGUMENTS` is provided (e.g., "Lecture4"): `./scripts/sync_to_docs.sh $ARGUMENTS`
   - If no argument: `./scripts/sync_to_docs.sh` (syncs all lectures)

2. **Verify deployment:**
   - Check that HTML files exist in `docs/slides/`
   - Check that `_files/` directories were copied (RevealJS assets)
   - Check that `docs/Figures/` was synced from `Figures/`
   - Check that `docs/files/code/` contains the R scripts (if `scripts/R/` has any)

3. **Verify interactive charts** (if applicable):
   - Grep rendered HTML for interactive widget count
   - Confirm count matches expected

4. **Verify TikZ SVGs** (if applicable):
   - Check that all referenced SVG files exist in `docs/Figures/LectureN/`

5. **Open in browser** for visual verification:
   - `open docs/slides/LectureX_Name.html`          # macOS
   - `# xdg-open docs/slides/LectureX_Name.html`    # Linux
   - Confirm slides render, images display, navigation works

6. **Report results** to the user

## What the sync script does:
- Renders all `.qmd` files in `Quarto/` (skips `*_backup*` files)
- Copies HTML and `_files/` directories to `docs/slides/`
- Copies Beamer PDFs from `Slides/` to `docs/slides/`
- Syncs `Figures/` to `docs/Figures/` using rsync
- Copies every `scripts/R/*.R` into `docs/files/code/` (published beside the slides)

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