SkillAgentSearch skills...

pi-heartbeat

Configure periodic health checks via HEARTBEAT.md and the /heartbeat command.

Install / Use

npx skills add espennilsen/pi --skill pi-heartbeat

Installs into whichever agent you are using.

About this skill
📄

SKILL.md

Installable skill definition

Quality Score

61/100

Supported Platforms

Universal

Tags

Our assessment of pi-heartbeat

pi-heartbeat scores 61/100 on our quality scale, 4069th of 4,617 Development & Engineering skills we index.

Its SKILL.md is 1.6 KB long, split into 5 sections with 1 code example: moderately detailed.

It has no GitHub stars yet, so there is no community track record; judge it on its content.

Substance
20/30
Structure
15/20
Description
12/15
Adoption
0/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated 12 days ago, so pi-heartbeat is actively maintained.
  • Our last check on 2026-10-18 found the source still online.
  • No license is declared. By default that means all rights are reserved: you can read it, but reusing or redistributing it is not clearly permitted. Ask the author before building on it commercially.
  • Its trust signals score 80/100, with 2 cautions from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

Safety scan

No issues found

Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.

AI review by kimi-k2.7-code on 2026-09-24. Automated pattern scan on 2026-09-24. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.

pi-heartbeat compared with similar skills

All 4 of these similar skills score higher than pi-heartbeat; compare them before choosing.

SkillScoreStarsUpdatedFormat
pi-heartbeat (this skill)by espennilsen61012d agoSKILL.md
taste-skillby Leonxlnx100110.6ktodayCLAUDE.md
ai-job-searchby ai-job-search-dev10069.8ktodayCLAUDE.md
claude-howtoby luongnv8910046.6k2d agoCLAUDE.md
algorithmic-artby anthropics100177.9k44d agoSKILL.md

Frequently asked questions

How do I install pi-heartbeat?
Run npx skills add espennilsen/pi --skill pi-heartbeat. The install tabs above show the steps for each supported agent.
Which AI agents does pi-heartbeat work with?
It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
Is pi-heartbeat safe to use?
Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It declares no license and scores 80/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is pi-heartbeat still maintained?
The repository was last updated 12 days ago, so pi-heartbeat is actively maintained.

name: pi-heartbeat description: Configure periodic health checks via HEARTBEAT.md and the /heartbeat command.

Pi Heartbeat Extension

Runs a periodic health-check prompt as an isolated subprocess.

Setup

  1. Enable via --heartbeat flag, /heartbeat on, or settings.json:

    { "pi-heartbeat": { "enabled": true, "intervalMinutes": 15 } }
    
  2. Create a HEARTBEAT.md in your project root with check items:

    # Heartbeat Checklist
    - [ ] Check git status — any uncommitted changes?
    - [ ] Check disk space — anything over 90%?
    - [ ] Review td list for blocked tasks
    
  3. If the agent responds with HEARTBEAT_OK, the result is suppressed. Any other response is treated as an alert and sent via pi-channels.

Configuration (settings.json)

{
  "pi-heartbeat": {
    "enabled": false,
    "intervalMinutes": 15,
    "activeHours": { "start": "08:00", "end": "22:00" },
    "route": "ops",
    "showOk": false,
    "prompt": null
  }
}
  • enabled: Start heartbeat on session start
  • intervalMinutes: Check frequency (default: 15)
  • activeHours: Only run during these hours (null = always)
  • route: pi-channels route for alerts (default: "ops")
  • showOk: Also send HEARTBEAT_OK results to the channel
  • prompt: Custom prompt (overrides HEARTBEAT.md)

Commands

  • /heartbeat on — Start periodic checks
  • /heartbeat off — Stop checks
  • /heartbeat status — Show run stats
  • /heartbeat run — Run a check immediately

Events

  • heartbeat:check — Emitted when a check starts
  • heartbeat:result — Emitted with { ok, response, durationMs }

Related Skills

View on GitHub
GitHub Stars0
CategoryDevelopment
Updated12d ago
Forks0

Trust signals

80/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

1 medium1 low