base-watcher-framework

Monitor filesystems and APIs, emitting events as Markdown to Obsidian.

11|2|Updated Apr 30, 2026
One-click install
npx skills add https://github.com/NaveedTechLab/skills-library --skill base-watcher-framework
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: base-watcher-framework
Source: https://github.com/NaveedTechLab/skills-library/tree/main/skills/base-watcher-framework
Command: npx skills add https://github.com/NaveedTechLab/skills-library --skill base-watcher-framework

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires aiohttp, pyyaml, watchdog, aiofiles, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides a robust framework for continuously monitoring filesystem changes, API endpoints, and other sources, automatically emitting events as Markdown to Obsidian, enabling seamless integration and analysis of monitoring data in Obsidian.

Core Features & Use Cases

  • Continuous Monitoring: Watch filesystems, REST APIs, and other sources for changes.
  • Event Emission: Automatically emit events to Obsidian vaults as Markdown files.
  • Custom Watchers: Extend the framework to create custom watchers for various sources.
  • Use Case: Imagine you want to monitor a directory for file changes and log them in Obsidian for further analysis. This Skill allows you to set up a filesystem watcher and automatically log events as Markdown files in Obsidian.

Quick Start

To start monitoring a directory, run the following command:

python scripts/cli.py watch ./docs --vault /path/to/obsidian/vault --patterns "*.md"

Frequently Asked Questions about base-watcher-framework

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

FAQPage Schema
How do I automate continuous filesystem monitoring and log events to Obsidian as Markdown?

Automate continuous filesystem monitoring by running the Python CLI script to watch directories and automatically emit change events to an Obsidian vault as Markdown files. You specify the target directory, vault path, and file patterns to start logging events.

Can I monitor REST API endpoints and log the changes in Obsidian?

Yes, you can monitor REST API endpoints using custom watchers within this framework. It continuously checks APIs for changes and emits the detected events as Markdown files directly into your Obsidian vault for seamless data integration and analysis.

What Python libraries are required to set up filesystem and API watchers?

Setting up filesystem and API watchers requires Python along with the aiohttp, pyyaml, watchdog, and aiofiles libraries. These dependencies provide the asynchronous HTTP requests, configuration parsing, and file system event tracking needed for continuous monitoring.

How do I extend the framework to create custom watchers for other event sources?

You extend the framework by creating custom watchers that monitor various sources beyond standard filesystem and API changes. This advanced implementation allows you to define specific events to track and emit them as Markdown to Obsidian.

Is there a simple command to start watching a directory for Markdown file changes?

Yes, to start watching a directory for Markdown file changes, run the Python CLI script with the watch command, specifying your target directory, Obsidian vault path, and file patterns to automatically generate event logs in your vault.