watch

Detect file changes via git-diff and route marker actions to skills.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/Buckeyes22/weather-app --skill watch-buckeyes22
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: watch
Source: https://github.com/Buckeyes22/weather-app/tree/main/docs/corpora/citadel-protocols/skills/watch
Command: npx skills add https://github.com/Buckeyes22/weather-app --skill watch-buckeyes22

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

You need a lightweight daemon that detects file changes and routes actionable insights to the right skills or intake queues, without manual triggering.

Core Features & Use Cases

  • Route @citadel: marker comments to the appropriate skill
  • Queue unmarked changes as intake items for /autopilot
  • Auto-trigger test runs when test files change
  • Flag doc staleness when source files change near docs

Quick Start

Start the watch, set a poll interval, and let it scan for changes to dispatch actions.

Frequently Asked Questions about watch

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I monitor file changes and auto-dispatch actions in my codebase?

You can monitor file changes by starting a watch daemon with a set poll interval, letting it scan for edits, and automatically routing actionable insights to appropriate skills or intake queues without manual triggering.

What is git-diff based change detection and how does it work for file monitoring?

Git-diff based change detection identifies modified files by comparing repository states, routing those changes and inline marker actions to appropriate skills. It falls back to timestamp-based detection when git is unavailable to ensure reliable operation.

Can I route inline marker comments to specific automated skills?

Yes, you can route inline marker comments, such as @citadel: markers, to the appropriate skill. The system parses these markers during file scans and dispatches the specified actions automatically.

How do I queue unmarked file changes as intake items for automated processing?

Unmarked file changes are automatically queued as intake items for automated processing. The system uses stateful intake tracking to capture unrecognized edits and route them into an intake queue for later review.

Does file change detection work without git in my project directory?

Yes, file change detection works without git by falling back to timestamp-based detection. This ensures reliable monitoring and dispatch of file changes even when git is unavailable in your project environment.

Are there limitations to batched dispatch when monitoring frequent file edits?

Batched dispatch limits automated actions to a maximum of five per scan to prevent overload when monitoring frequent file edits. This constraint ensures stable routing of marker actions and intake generation across tests, docs, and source files.