file-watcher — скилл для Claude Code: что делает и как установить
Скилл file-watcher настраивает хуки Claude Code для отслеживания изменений в .env, package.json и конфигурациях проекта.
MIT ★ 2 966 обновлён 2026-09-29
/plugin marketplace add rohitg00/pro-workflow
/plugin install pro-workflow@pro-workflowЧто делает 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-code3Вручную: положить файлы
~/.claude/skills/file-watcher/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/file-watcher/
1Через Skills CLI (Vercel)
npx skills add rohitg00/pro-workflow --skill file-watcher -a codex2Вручную: положить файлы
.agents/skills/file-watcher/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add rohitg00/pro-workflow --skill file-watcher -a cursor2Вручную: положить файлы
.cursor/skills/file-watcher/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install rohitg00/pro-workflow skills/file-watcher2Вручную: положить файлы
.github/skills/file-watcher/SKILL.md1Через Skills CLI (Vercel)
npx skills add rohitg00/pro-workflow --skill file-watcher -a gemini-cli2Командой платформы
gemini skills install https://github.com/rohitg00/pro-workflow --path skills/file-watcherВручную: положить файлы
.devin/skills/file-watcher/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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