watcher-runner-filesystem

Features and purpose

Run, smoke-test, and debug the Bronze-tier filesystem watcher (Python) that monitors a local drop folder and creates markdown action items inside the Obsidian vault's /Needs_Action folder. This skill should be used when the user asks to "run the watcher", "start the filesystem watcher", "debug why Needs_Action is not updating", "watch a folder for new files", "test the watcher end-to-end", or when Claude needs to validate the Perception layer of Hackathon Zero without Gmail/OAuth. Trigger phrases include: "filesystem watcher", "drop folder", "watchdog", "watcher logs", "no files appearing in Needs_Action", "uv run watcher", and "watchdog observer".

Quick start

Follow the repository instructions for this skill and your agent. Review the files and dependencies before adding it to your workflow.