bot-heartbeat
Pilot Bot heartbeat — spawns background subagent for periodic health check, notifies only when issues are detected
npx skills add majiayu000/claude-skill-registry --skill bot-heartbeat --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Bot Heartbeat Skill Spawns a background subagent to run periodic checks. The main session is released immediately after the subagent is launched. ## Steps 1. Launch a subagent with `run_in_background=true` 2. Main session exits immediately (does not wait for subagent completion) ## Background Subagent Prompt Prompt to pass to the subagent: ``` You are a heartbeat agent for Pilot Bot. Steps: 1. Run: bash $PILOT_BOT_DIR/../../.claude/skills/bot-heartbeat/scripts/check.sh If the script outputs "SKIP", exit immediately (dedup — heartbeat already ran recently). 2. Evaluate whether any issues exist (dead processes, failed jobs, etc.) 3. Check if Telegram MCP tools (reply, react) are available. Track telegram_available. 4. Notification rule: - NO issues → do NOT send any message. Stay silent. - Issues found AND telegram_available → send issue details via Telegram reply (brief, no "alive" prefix) - Issues found AND NOT telegram_available → output alert to console only. 5. Exit. Keep it brief. Do not ask questions. Do not wait for responses. ``` ## Lock File Dedup The check.sh script implements lock file deduplication: - Lock file: `$PILOT_BOT_DIR/.heartbeat-lock` - Threshold: 1350s (75%
- Steps
- Background Subagent Prompt
- Lock File Dedup
- Usage
- Note
What does the bot-heartbeat skill do?
Pilot Bot heartbeat — spawns background subagent for periodic health check, notifies only when issues are detected
How do I install it?
Run `npx skills add majiayu000/claude-skill-registry --skill bot-heartbeat --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From majiayu000/claude-skill-registry, a repository with 534 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.