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

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

Скилл claude-vigil создаёт чекпоинты файлов и автоматически сохраняет их перед опасными bash-командами вроде rm или git reset. Защищает проект от случайной потери кода.

MIT ★ 78 обновлён 2026-03-05

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

Что делает claude-vigil

Скилл отслеживает вызовы терминала через хук PreToolUse(Bash). Если агент собирается выполнить rm, mv, sed -i или сбросить рабочую копию через git reset, плагин делает снимок затрагиваемых файлов до запуска команды. Безопасные операции не тратят токены, а на опасных командах уходит порядка 30–50 токенов.

Для ручного управления версиями доступны команды /save-vigil и /restore-vigil. Файлы упаковываются через gzip с дедупликацией по SHA-256 в каталог .claude/vigil/. Доступны просмотр изменений через vigil_diff и восстановление файлов из сохранённого состояния.

Локальное хранилище вмещает всего 3 именованных слота и один ротируемый слот ~quicksave. Для работы плагину требуется запущенный MCP-сервер, который подключается вызовом claude mcp add vigil -- npx claude-vigil-mcp.

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

  • откатить файлы после случайного запуска rm или mv
  • сохранить именованный снимок файлов перед сложным рефакторингом
  • просмотреть diff между рабочей копией и точкой восстановления
  • защитить код от очистки при вызовах git reset или git clean

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

  • /save-vigil before-refactor src/auth.ts src/middleware.ts
  • /restore-vigil before-refactor
  • покажи список доступных снимков через vigil_list и сравни изменения

Как установить claude-vigil

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

/plugin marketplace add Vvkmnn/claude-emporium
/plugin install claude-vigil@claude-emporium

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

2Через Skills CLI (Vercel)

npx skills add Vvkmnn/claude-emporium --skill claude-vigil -a claude-code

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

~/.claude/skills/claude-vigil/SKILL.md

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

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

Вопросы о claude-vigil

Как установить claude-vigil в Claude Code?

Выполните в терминале агента по очереди две команды: /plugin marketplace add Vvkmnn/claude-emporium, затем /plugin install claude-vigil@claude-emporium. После этого добавьте MCP-сервер: claude mcp add vigil -- npx claude-vigil-mcp.

Что делает claude-vigil?

Скилл управляет снимками файлов, показывает разницу изменений и возвращает файлы к контрольной точке. Он автоматически сохраняет код перед потенциально деструктивными операциями в терминале.

Сколько чекпоинтов сохраняет claude-vigil?

В каталоге .claude/vigil/ предусмотрено 3 именованных слота и 1 перезаписываемый слот ~quicksave для автоматических сохранений.

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

SKILL.md · MIT
---
name: claude-vigil
description: File checkpoint and recovery — auto-quicksaves before destructive commands, manual checkpoints for safe rollback
triggers: [PreToolUse]
---

# Vigil Plugin

File recovery. Saves checkpoints before dangerous operations, diffs changes, restores files safely.

## Hooks

| Hook | When | Action |
|------|------|--------|
| **PreToolUse(Bash)** | Destructive command detected | Auto-quicksaves affected files (rm, mv, git reset, etc.) |

Token cost: 0 on safe commands, ~30-50 on destructive. The regex matches: `rm`, `rmdir`, `mv`, `sed -i`, `perl -i`, `git checkout/reset/clean/restore`, output redirects.

## Commands

| Command | Description |
|---------|-------------|
| `/save-vigil <name> [files]` | Create a named file checkpoint |
| `/restore-vigil [name]` | Restore files from a checkpoint |

## Workflows

### Checkpoint (standalone)

1. `vigil_save(name: "before-refactor", files: ["src/auth.ts", "src/middleware.ts"])`
2. Make changes safely
3. If something breaks: `vigil_restore(name: "before-refactor")`

### Checkpoint (with siblings)

1. `vigil_save(name: "before-refactor", files: [...])`
2. If **praetorian** active: also `praetorian_compact(type: "decisions", ...)` to save the reasoning
3. Make changes — both files and context are now protected
4. If something breaks:
   - `vigil_restore(name: "before-refactor")` — restore files
   - `praetorian_restore("before-refactor")` — restore context

### Recovery (standalone)

1. `vigil_list()` — see available checkpoints
2. `vigil_diff(name: "checkpoint")` — preview what would change
3. `vigil_restore(name: "checkpoint")` — restore files
4. Optionally: `vigil_delete(name: "checkpoint")` — clean up

### Recovery (with siblings)

1. `vigil_list()` — see available checkpoints
2. `vigil_diff(name: "checkpoint")` — preview changes
3. If **historian** active: `find_file_context("filename")` to understand what changed and why
4. `vigil_restore(name: "checkpoint")` — restore files
5. If **praetorian** active: restore matching compaction for context

## Sibling Synergy

| Sibling | Value | How |
|---------|-------|-----|
| **Praetorian** | Context saved alongside files | Pair vigil checkpoints with praetorian compactions for full state recovery |
| **Historian** | File change context from history | `find_file_context()` explains what happened between checkpoint and now |

## MCP Tools Reference

| Tool | Purpose |
|------|---------|
| `vigil_save` | Create named checkpoint (SHA-256 + gzip dedup) |
| `vigil_list` | List available checkpoints with metadata |
| `vigil_diff` | Preview changes since checkpoint |
| `vigil_restore` | Restore files from checkpoint |
| `vigil_delete` | Remove a checkpoint and free storage |

## Storage

Content-addressable at `.claude/vigil/`. 3 named slots + 1 rotating `~quicksave`.

## Requires

```
claude mcp add vigil -- npx claude-vigil-mcp
```

© vvkmnn · MIT · Vvkmnn/claude-emporium

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

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
using-entire entireio Скилл using-entire для Claude Code и Codex, который сначала читает историю намерений в задачах исследования кода. Он выбирает подходящий сценарий Entire до Glob, Grep или Read. CX Codex +1 480установок workflow-director rohitg00 Субагент workflow-director для Claude Code, который управляет многошаговыми workflow'ами от начала до конца с контрольными точками и откатом ошибок. CX Codex ★ 2 858звёзд репо git-merge-expert ulpi-io Скилл git-merge-expert сливает ветки и PR, разбирает конфликты и откатывает неудачные merge. До начала работы проверяет готовность и ставит бэкап-тег. CX Codex +1 182установок git-commit ilteoood Скилл git-commit для Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode анализирует diff и генерирует сообщение коммита по спецификации Conventional Commits. CX Codex +1 624установок careful garrytan Скилл careful для Claude Code ставит хук, который проверяет команды Bash и PowerShell до запуска. На каждый rm -rf, DROP TABLE или git push --force агент спрашивает подтверждение. CX Codex +1 417установок claude-code-bash-patterns secondsky Скилл claude-code-bash-patterns обучает агента безопасно запускать CLI-команды, связывать их через && и настраивать хуки pretooluse. Помогает избежать сбоев при сборке и запретить опасный вызов rm -rf. CX Codex +1 414установок

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

Весь набор →
compact-praetorian Команда compact-praetorian для Claude Code, которая сохраняет текущий контекст сессии в praetorian-память для использования в следующих сессиях. CX Codex +1 ★ 78звёзд репо review-gladiator Команда review-gladiator анализирует историю сессий Claude Code, группирует наблюдения и предлагает правила для улучшения воркфлоу. CX Codex +1 ★ 78звёзд репо claude-oracle Скилл claude-oracle ищет подходящие скиллы, плагины и MCP-серверы по 17 источникам. Запускает поиск перед планированием и после ошибок Bash. CX Codex +1 ★ 78звёзд репо claude-praetorian Скилл claude-praetorian снимает копию контекста перед сбросом и возвращает её позже: перед планированием, после веб-поиска, по завершении субагента. CX Codex +1 ★ 78звёзд репо claude-orator Скилл claude-orator для Claude Code оценивает промпты по семи параметрам и предлагает переработанную версию. Оптимизирует запросы субагентам и проверяет промпты пакетно. CX Codex +1 ★ 78звёзд репо claude-historian Скилл claude-historian автоматически ищет решения в прошлых сессиях перед тем, как запускать веб-поиск, планирование или отладку. Экономит время на повторную работу и связывает знания между проектами. CX Codex +1 ★ 78звёзд репо claude-gladiator Скилл claude-gladiator отслеживает сбои инструментов, накапливает наблюдения и предлагает обновить правила и скиллы в конце сессии. Помогает агенту учиться на собственных ошибках. CX Codex +1 ★ 78звёзд репо claude-orator Плагин claude-orator для Claude Code оценивает и перестраивает промпты перед передачей субагентам. Хук предлагает оптимизацию для расплывчатых запросов к субагенту. ★ 78звёзд репо

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

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