# Heartbeat

> Periodic heartbeat check that reads HEARTBEAT.md from the workspace and executes any tasks listed there. Use for autonomous background monitoring, periodic maintenance, and proactive task execution. Triggered by a cron schedule.

- **Type:** Skill
- **Install:** `agentstack add skill-tao12345666333-amcp-heartbeat`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [tao12345666333](https://agentstack.voostack.com/s/tao12345666333)
- **Installs:** 0
- **Category:** [Communication](https://agentstack.voostack.com/c/communication)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [tao12345666333](https://github.com/tao12345666333)
- **Source:** https://github.com/tao12345666333/amcp/tree/main/src/amcp/builtin_skills/heartbeat
- **Website:** https://x.com/zhangjintao9020/status/1995170132973466018?s=20

## Install

```sh
agentstack add skill-tao12345666333-amcp-heartbeat
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Heartbeat

Periodic agent wake-up to check for tasks in `HEARTBEAT.md`.

## How It Works

1. Every 30 minutes, the scheduler triggers this skill
2. Read `HEARTBEAT.md` from the workspace root
3. If file is empty or has no actionable content → reply `HEARTBEAT_OK` and stop
4. If file has tasks → execute them one by one
5. Mark completed tasks by moving them to the `## Completed` section
6. If `telegram-sender` skill is available and the task warrants notification, send a Telegram update

## HEARTBEAT.md Format

```markdown
# Heartbeat Tasks

## Active Tasks

- Check CI status for open PRs and fix any failures
- Review and merge dependabot PRs if tests pass

## Completed

- [2026-02-17] Cleaned up stale branches
```

## Rules

- **Empty = skip**: If `HEARTBEAT.md` is missing, empty, or only has headers/comments, reply `HEARTBEAT_OK`
- **Task markers**: Lines starting with `- ` under `## Active Tasks` are actionable
- **Completion**: After finishing a task, move it to `## Completed` with today's date prefix
- **Errors**: If a task fails, leave it in Active Tasks and append `(FAILED: reason)` to the line
- **Safety**: Never delete `HEARTBEAT.md`, only modify task entries
- **Scope**: Tasks should be self-contained and completable within the timeout (5 minutes)

## Skipable Content

These are not actionable (skip them):
- Empty lines
- Lines starting with `#` (headers)
- Lines starting with `<!--` (HTML comments)
- Lines with only `- [ ]` or `- [x]` (empty checkboxes)

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [tao12345666333](https://github.com/tao12345666333)
- **Source:** [tao12345666333/amcp](https://github.com/tao12345666333/amcp)
- **License:** Apache-2.0
- **Homepage:** https://x.com/zhangjintao9020/status/1995170132973466018?s=20

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-tao12345666333-amcp-heartbeat
- Seller: https://agentstack.voostack.com/s/tao12345666333
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.