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

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

Скилл file-watcher настраивает хуки Claude Code для отслеживания изменений в .env, package.json и конфигурациях проекта.

MIT ★ 2 966 обновлён 2026-09-29

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

Что делает file-watcher

Скилл помогает связать события файловой системы с поведением Claude Code. Для этого используются хуки SessionStart и CwdChanged, возвращающие список путей watchPaths, а также хук FileChanged, реагирующий на правки файлов вроде .env или package.json.

Обработчики могут передавать переменные окружения в сессию агента через запись в CLAUDE_ENV_FILE. Наблюдатель использует порог стабильности 500 мс и опрос с интервалом 200 мс. Для watchPaths обязательны абсолютные пути, иначе Claude Code их проигнорирует, а сами скрипты-обработчики должны отрабатывать быстрее 5 секунд во избежание блокировки.

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

  • настроить перезагрузку окружения при изменении .env
  • напоминать о запуске npm install после правок package.json
  • перезапускать проверку типов при модификации tsconfig.json
  • передавать переменные окружения в команды сессии через CLAUDE_ENV_FILE

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

  • Настрой отслеживание package.json и напомни обновить зависимости при изменении
  • Добавь хук FileChanged для автоматической подгрузки переменных из .env
  • Покажи конфигурацию hooks.json для наблюдения за tsconfig.json

Как установить file-watcher

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

/plugin marketplace add rohitg00/pro-workflow
/plugin install pro-workflow@pro-workflow

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

2Через Skills CLI (Vercel)

npx skills add rohitg00/pro-workflow --skill file-watcher -a claude-code

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

~/.claude/skills/file-watcher/SKILL.md

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

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

Вопросы о file-watcher

Как установить file-watcher в Claude Code?

Выполните в терминале Claude Code сначала /plugin marketplace add rohitg00/pro-workflow, а затем команду /plugin install pro-workflow@pro-workflow.

Что делает скилл file-watcher?

Он задаёт шаблоны конфигурации хуков Claude Code, чтобы агент автоматически реагировал на изменение файлов проекта и обновлял окружение.

Какие технические ограничения нужно учесть?

Параметр watchPaths принимает только абсолютные пути, а скрипты обработчиков обязаны завершаться менее чем за 5 секунд, чтобы не подвесить сессию.

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

SKILL.md · MIT
---
name: file-watcher
description: Configure file watching hooks to auto-react to config changes, env file updates, and dependency modifications. Use to set up reactive workflows.
user-invocable: true
---

# File Watcher

Use Claude Code's `FileChanged` and `CwdChanged` hooks to create reactive workflows that respond to file system changes.

## Trigger

Use when:
- Setting up auto-reload for config changes
- Watching for dependency updates
- Monitoring build output
- Creating reactive development workflows

## How File Watching Works

Claude Code's `SessionStart` and `CwdChanged` hooks support returning `watchPaths` to register file watchers. The current `cwd-changed.js` script focuses on env injection; to add watch registration, your hook script must output this JSON structure:

```json
{
  "hookSpecificOutput": {
    "hookEventName": "SessionStart",
    "watchPaths": [
      "/absolute/path/to/.env",
      "/absolute/path/to/package.json"
    ]
  }
}
```

When watched files change, the `FileChanged` hook fires with:
```json
{
  "hook_event_name": "FileChanged",
  "file_path": "/path/to/changed/file",
  "event": "change"
}
```

## Environment Injection

`CwdChanged` and `FileChanged` hooks can write to `CLAUDE_ENV_FILE` to inject environment variables into subsequent Bash commands:

```bash
echo "export PROJECT_TYPE=node" >> "$CLAUDE_ENV_FILE"
echo "export TEST_CMD='npm test'" >> "$CLAUDE_ENV_FILE"
```

## Common Watch Patterns

### Watch .env for Changes
```javascript
const envFile = path.join(projectRoot, '.env');
if (fs.existsSync(envFile)) {
  output.hookSpecificOutput = {
    hookEventName: 'SessionStart',
    watchPaths: [envFile]
  };
}
```

### Watch package.json for Dependency Changes
Detect when dependencies change and remind to run `npm install`.

### Watch tsconfig.json for Config Changes
Remind to restart TypeScript checks when config changes.

## Setup

Add to hooks.json:
```json
{
  "FileChanged": [{
    "matcher": ".env|package.json|tsconfig.json",
    "hooks": [{
      "type": "command",
      "command": "node scripts/file-changed.js"
    }]
  }]
}
```

## Rules

- Use absolute paths for watchPaths (required by Claude Code)
- Matcher uses pipe-separated filenames
- Watcher uses 500ms stability threshold and 200ms poll interval
- Keep file-changed handlers fast (<5s) to avoid blocking
- Use `CLAUDE_ENV_FILE` for injecting env vars, not direct export

© Rohit Ghumare · MIT · rohitg00/pro-workflow

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

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
reg-feed-watcher официальный anthropics Скилл reg-feed-watcher отслеживает обновления регуляторов через API и RSS, отсекает незначительные публикации и группирует главное по уровню существенности. CX Codex +1 625установок launch-watcher официальный Anthropic Субагент launch-watcher для Claude Code отслеживает предстоящие релизы в Jira или Linear и находит задачи с юридическими триггерами. CX Codex ★ 10 060звёзд репо aave-v3-liquidation-watcher-teneo TeneoProtocolAI Скилл aave-v3-liquidation-watcher-teneo для Claude Code подключает агента Teneo для Aave V3 и запускает его через CLI. Показывает актуальные команды, аргументы и цену запроса. CX Codex +1 517установок network-watcher UseAI-pro Скилл network-watcher проверяет, куда скиллы OpenClaw ходят по сети, и ловит утечку данных до установки. CX Codex +1 455установок File Analysis API with Node.js and Express [email protected] Промпт File Analysis API with Node.js and Express для разбора загруженных файлов в API на Express: добавляет логику анализа, не ломая формат ответа. GP ChatGPT ★ 178 201звёзд репо nodejs-mongodb-cursorrules-prompt-file-tutorial PatrickJS Правило nodejs-mongodb-cursorrules-prompt-file-tutorial задаёт Cursor правила бэкенда на Node.js, Express и MongoDB с Mongoose, а также логику пулов со ставками, заявками и подсчётом очков. CX Codex +1 ★ 41 178звёзд репо

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

Весь набор →
cost-analyst Субагент cost-analyst разбирает расход токенов по операциям, проверяет попадания в кэш и предлагает конкретные способы сократить стоимость сессии. CX Codex ★ 2 966звёзд репо context-engineer Субагент context-engineer анализирует потребление контекстного окна сессии, оценивает здоровье конфигов и предлагает шаги по экономии токенов. Пригодится при частой компактификации. CX Codex ★ 2 966звёзд репо pre-flight-discipline Правило pre-flight-discipline заставляет агента проговаривать допущения, сужать задачу и проверять результат по шагам. Подходит для кода, где опасны лишние правки. CX Codex +1 ★ 2 966звёзд репо smart-commit Скилл smart-commit гоняет линт, тайпчек и тесты перед коммитом, просматривает стейдж на мусор и собирает сообщение в формате conventional commits. CX Codex +1 ★ 2 966звёзд репо commit Команда commit собирает изменения в осмысленный git-коммит после линтера, проверки типов и тестов. Подходит для контролируемого завершения работы над задачей. CX Codex +1 ★ 2 966звёзд репо mcp-audit Скилл mcp-audit анализирует подключённые MCP-серверы на предмет токенов, дублирования и безопасности. Запускай, когда сессии медлят или перед добавлением нового сервера. CX Codex +1 ★ 2 966звёзд репо tdd Скилл tdd задаёт для Claude Code цикл разработки через тесты: сначала падающий тест, затем минимальный рабочий код и рефакторинг. CX Codex +1 ★ 2 966звёзд репо module-shape Правило module-shape помогает держать публичный интерфейс модулей узким, а сложность — внутри. Оно пригодится при проектировании и ревью кода. CX Codex +1 ★ 2 966звёзд репо

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

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