OpenParable
Skip to content
← Back to skills

Claw Heartbeat Delegation

Productivity
claw-heartbeat-delegation

Claw Heartbeat Delegation is an Agent Skill for productivity published in the x-cmd/x-cmd repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Task delegation to the heartbeat agent via HEARTBEAT.md. Use when scheduling follow-ups, recurring checks, or recording background jobs for later monitoring.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/x-cmd/x-cmd/blob/HEAD/mod/claw/lib/data/workspace/manager/skills/heartbeat-delegation/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/claw-heartbeat-delegation, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Heartbeat Delegation

Overview

HEARTBEAT.md is your delegation form to the heartbeat agent. Write clearly what needs to be done and when. The heartbeat agent reads and processes it during idle periods.

  • One-time tasks (## In Progress): After execution, the heartbeat agent marks them completed or removes them.
  • Recurring tasks (## Recurring): After execution, the heartbeat agent records the run in its own memory/state.yml but keeps the task in HEARTBEAT.md for future runs.

Important: Do NOT execute items in HEARTBEAT.md yourself during the current session. Your role is to read it for awareness of pending follow-ups, but execution is the heartbeat agent's responsibility. If a user asks about a HEARTBEAT.md item, briefly summarize its status; only perform the action if the user explicitly says "do it now" or similar.

Format Reference

One-time follow-up

Write under ## In Progress:

- **Follow-up**: `<task-id>`
  - **Due**: YYYY-MM-DD HH:MM
  - **Task**: <description>

Recurring check

Write under ## Recurring:

- **Recurring**: `<task-id>`
  - **Frequency**: <hourly | daily | weekly>
  - **Task**: <description>

Background Job record

When you create a background job via x agent run, also record it in HEARTBEAT.md under ## In Progress:

- **Background Job**: `<job-id>`
  - **Display Name**: <friendly name>
  - **IM**: <im>
  - **Chat ID**: <chatid>
  - **Task**: <brief description>
  - **Created**: <timestamp>
  - **Check command**: `x agent job status --job-id <job-id> --llms`
  - **Notify command**: `x claw agentrequest <im> <chatid> '<summary>'`

Checking Completion

The heartbeat agent periodically checks active background jobs:

  1. Run: x agent job status --job-id "<id>" --llms
  2. Read the output to determine if the job is done, failed, or still running
  3. When done, report the summary to the user directly via stdout in the next session, or send a notification to the relevant platform if appropriate