heartbeat

Automate heartbeat monitoring configuration and alerting for Istota deployments.

10|Updated Feb 17, 2026
One-click install
npx skills add https://github.com/istota-project/istota --skill heartbeat-istota-project
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: heartbeat
Source: https://github.com/istota-project/istota/tree/main/src/istota/skills/heartbeat
Command: npx skills add https://github.com/istota-project/istota --skill heartbeat-istota-project

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates heartbeat monitoring configuration for Istota deployments, enabling timely detection and alerting of failures to minimize downtime.

Core Features & Use Cases

  • Defines multiple check types (file-watch, shell-command, url-health) and configurations to validate system health.
  • Supports quiet hours, default and per-check cooldowns, and per-check intervals to balance alerting with noise control.
  • Enables quick deployment of health checks in Nextcloud-backed AI workflows to ensure availability.

Quick Start

Edit your {BOT_DIR}/config/HEARTBEAT.md to define checks and run the scheduler to start health monitoring.

Frequently Asked Questions about heartbeat

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

FAQPage Schema
How do I configure automated heartbeat monitoring for Nextcloud deployments?

Configure automated heartbeat monitoring by editing the HEARTBEAT.md file to define file-watch, shell-command, and url-health checks. The system enforces these TOML-based settings at runtime to validate service health and trigger alerts for your Nextcloud-backed environments.

Can I set quiet hours and cooldowns to control alert noise during uptime monitoring?

Yes, heartbeat monitoring supports quiet hours, default cooldowns, and per-check cooldowns to control alert noise. You can also specify per-check intervals to balance timely failure detection with alert suppression during configured quiet periods.

What types of health checks can I automate for my AI agent workflows?

You can automate file-watch, shell-command, and url-health checks for AI agent workflows. These check types validate file availability, service health, and API responses, triggering alerts on failures to ensure system availability.

Do I need a TOML settings schema to define service health checks?

Yes, the system uses a TOML-based settings schema to specify per-check rules for your service health checks. This schema defines intervals, cooldowns, and quiet hours that the runtime enforces when validating API responses and file availability.

What is the best way to detect downtime quickly in Nextcloud-backed environments?

The best way to detect downtime is deploying automated heartbeat monitoring with configurable intervals. By defining url-health and file-watch checks in your config, the system validates availability and triggers immediate alerts upon detecting failures.

Why are my heartbeat checks not triggering alerts during service failures?

Heartbeat checks may not trigger alerts if quiet hours are active or per-check cooldowns have not elapsed. Verify your TOML settings schema to ensure intervals are configured correctly and cooldown periods are not suppressing failure notifications.