Agent skill

Vellum Heartbeat

by vellum-ai in vellum-ai/vellum-assistant

Configure periodic background checklist runs. An agent skill from vellum-ai/vellum-assistant.

MITAuto-check passed

Install Vellum Heartbeat

skills CLI
$ npx skills add vellum-ai/vellum-assistant --skill vellum-heartbeat -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install vellum-ai/vellum-assistant vellum-heartbeat --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/vellum-ai/vellum-assistant.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/vellum-heartbeat .claude/skills/vellum-heartbeat && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
vellum-heartbeat
GitHub stars
1.4k
Token cost
~513 tokens
SKILL.md length
185 words
Files
1
Skills in repo
108
Repo updated
First seen
Licence
MIT

At a glance

Configure periodic background checklist runs. An agent skill from vellum-ai/vellum-assistant.

  • Works in 3 steps: Enable heartbeat: Set heartbeat.enabled… → Set interval: Set heartbeat.intervalMs… → Optional active hours: Set…
  • SKILL.md covers Setup, Notes and Inference
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Vellum Heartbeat is an agent skill from vellum-ai/vellum-assistant. Configure periodic background checklist runs

Its SKILL.md is about 510 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts. Compatibility notes: Designed for Vellum personal assistants

The repository describes itself as: An AI Assistant that’s easy to setup, does your work 24/7, knows your preferences and gets better over time. The licence is MIT.

Example prompts

  • “/vellum-heartbeat”

Requirements

  • Compatibility (from SKILL.md): Designed for Vellum personal assistants

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Enable heartbeat: Set heartbeat.enabled to true.
  2. Set interval: Set heartbeat.intervalMs (milliseconds between runs, default: 3600000 = 1 hour).
  3. Optional active hours: Set heartbeat.activeHoursStart and heartbeat.activeHoursEnd (0-23) to restrict runs to certain hours in the…

What it can do on your machine

Read from SKILL.md and the folder at commit 33cc983. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are json).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

  • Compatibility

    Designed for Vellum personal assistants

    From compatibility in the SKILL.md frontmatter.

Context cost

Vellum Heartbeat loads about 513 tokens when it runs. Until then it costs about 15 tokens; SKILL.md has 185 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~15
When it runs · the whole SKILL.md, loaded when a task matches
~513

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from vellum-ai/vellum-assistant at commit 33cc983, republished under its MIT licence (© vellum-ai). 185 words, ~513 tokens.

Download SKILL.mdSave it as .claude/skills/vellum-heartbeat/SKILL.md (or your agent's skills folder).
name
vellum-heartbeat
description
Configure periodic background checklist runs
compatibility
Designed for Vellum personal assistants
metadata.emoji
💓

The heartbeat feature runs your HEARTBEAT.md checklist periodically in a background conversation. Each run, the assistant works through the checklist and flags anything that needs attention.

Setup

Edit config.json using file_edit:

  1. Enable heartbeat: Set heartbeat.enabled to true.
  2. Set interval: Set heartbeat.intervalMs (milliseconds between runs, default: 3600000 = 1 hour).
  3. Optional active hours: Set heartbeat.activeHoursStart and heartbeat.activeHoursEnd (0-23) to restrict runs to certain hours in the heartbeat timezone. Hours use heartbeat.timezone when set, otherwise the user's configured or detected timezone (the host clock is last resort). Both must be set together.

Example config.json heartbeat section:

json
{
  "heartbeat": {
    "enabled": true,
    "intervalMs": 1800000,
    "activeHoursStart": 8,
    "activeHoursEnd": 22
  }
}

Then edit HEARTBEAT.md with the checklist items. The assistant will work through this file each heartbeat run.

Notes

  • Toggling heartbeat.enabled requires an assistant restart to take effect.
  • Changes to HEARTBEAT.md take effect on the next heartbeat run (no restart needed).
  • The heartbeat runs in a separate background conversation, not the user's active chat.

Inference

Heartbeat runs use the heartbeatAgent call site, which by default resolves to the cost-optimized profile so background checks stay cheap. Override via llm.callSites.heartbeatAgent in workspace config (profile, provider, model, effort, thinking — whatever the profile supports).

© vellum-ai, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/vellum-heartbeat of vellum-ai/vellum-assistant.

Open the folder on GitHubat commit 33cc983

Compare with similar skills

Vellum Heartbeat next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Vellum Heartbeat compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Vellum Heartbeat this skillvellum-ai/vellum-assistant1.4k—~513Automated safety check: PassMIT
Configure Channelopenclaw/openclaw392k—~946Automated safety check: PassMIT
Python Background Jobswshobson/agents40k—~1.8kAutomated safety check: PassMIT
ConfigurationBuilderIO/agent-native7.1k—~2.1kAutomated safety check: PassNone
Backgroundjeremylongshore/tons-of-skills-marketplace2.8k—~2.2kAutomated safety check: PassMIT
Configure Eccaffaan-m/ECC277k1 repos~2kAutomated safety check: PassMIT

Similar skills

  • Configure Channel

    openclaw/openclaw

    Configure and prove a chat channel with non-interactive one-liners; secrets only as SecretRefs.

    392k GitHub stars~946 tokensUpdated today
    Auto-check passed
  • Python Background Jobs

    wshobson/agents

    Python background job patterns including task queues, workers, and event-driven architecture.

    40k GitHub stars~1.8k tokensUpdated 6 days ago
    Backend & APIsAuto-check passed
  • Configuration

    BuilderIO/agent-native

    Where a configuration value belongs — app config schema, agent-native.config.ts, or an environment variable — and how the layers resolve.

    7.1k GitHub stars~2.1k tokensUpdated yesterday
    DevOps & CloudAuto-check passed
  • Background

    jeremylongshore/tons-of-skills-marketplace

    A skill your agent uses when the user wants to see, inspect, cancel, or prune background agents fired during prior chain runs.

    2.8k GitHub stars~2.2k tokensUpdated yesterday
    Auto-check passed
  • Configure Ecc

    affaan-m/ECC

    Run the conversational ECC setup wizard inside the current harness: inventory the install, collect scope (user/project/local) and hook mode (off/minimal/standard/strict) in Claude Code, use Codex's…

    277k GitHub starsUsed in 1 repo~2k tokens
    Auto-check passed
  • Configure Ecc

    affaan-m/ECC

    Claude Code、Codex、Kimi 内で ECC のインストール、更新、再設定を案内し、各ハーネスが実際に備えるプラグイン、スコープ、フック機能を守ります。

    276k GitHub stars~1.3k tokensUpdated yesterday
    Auto-check passed

More from vellum-ai/vellum-assistant

All 108 skills in this repo
  • Vellum GitHub App Setup

    vellum-ai/vellum-assistant

    Create and configure a GitHub App so the assistant can push commits, open PRs, and comment under its own bot identity.

    1.4k GitHub stars~3.1k tokensUpdated yesterday
    Auto-check passed
  • Discord App Setup

    vellum-ai/vellum-assistant

    Connect a Discord bot to the assistant via the Discord Gateway with guided application creation and intent configuration

    1.4k GitHub stars~4.2k tokensUpdated yesterday
    Auto-check passed
  • Sentry App Setup

    vellum-ai/vellum-assistant

    Create and configure a Sentry internal integration so the assistant can manage issues, alerts, and releases under its own identity

    1.4k GitHub stars~1.3k tokensUpdated yesterday
    Auto-check passed
  • Memory Corpus Ingest

    vellum-ai/vellum-assistant

    Ingest a large dataset into memory as a skimmed map. An agent skill from vellum-ai/vellum-assistant.

    1.4k GitHub stars~3k tokensUpdated yesterday
    Auto-check: notes
  • Plugin Builder

    vellum-ai/vellum-assistant

    A skill your agent uses when the user wants to build, scaffold, ship, or edit a Vellum plugin that bundles multiple surfaces (hooks, tools, skills, and more) into one installable package.

    1.4k GitHub stars~3.1k tokensUpdated yesterday
    Auto-check passed
  • Slack App Setup

    vellum-ai/vellum-assistant

    Connect a Slack app to the Vellum Assistant via Socket Mode.

    1.4k GitHub stars~2.5k tokensUpdated yesterday
    Auto-check: warnings

Questions about Vellum Heartbeat

What does Vellum Heartbeat do?

Configure periodic background checklist runs. An agent skill from vellum-ai/vellum-assistant. Vellum Heartbeat is an agent skill from vellum-ai/vellum-assistant.

How do I install Vellum Heartbeat in Claude Code?

Run `npx skills add vellum-ai/vellum-assistant --skill vellum-heartbeat -a claude-code`. Or copy the skill folder (skills/vellum-heartbeat in vellum-ai/vellum-assistant) into .claude/skills/vellum-heartbeat in your project. Claude Code loads it when a task matches its description.

How do I install Vellum Heartbeat in Codex?

Run `npx skills add vellum-ai/vellum-assistant --skill vellum-heartbeat -a codex`. Or copy the skill folder (skills/vellum-heartbeat in vellum-ai/vellum-assistant) into .agents/skills/vellum-heartbeat in your project. Codex loads it when a task matches its description.

Can I use Vellum Heartbeat in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add vellum-ai/vellum-assistant --skill vellum-heartbeat -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/vellum-heartbeat, .gemini/skills/vellum-heartbeat, .github/skills/vellum-heartbeat and .opencode/skills/vellum-heartbeat in your project.

What does Vellum Heartbeat need to run?

SKILL.md names no scripts, command-line tools or credentials: Vellum Heartbeat is instructions for the agent only. Compatibility (from SKILL.md): Designed for Vellum personal assistants.

Does Vellum Heartbeat access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Vellum Heartbeat safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Vellum Heartbeat use?

Vellum Heartbeat is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Vellum Heartbeat use?

About 513 tokens (SKILL.md is roughly 2.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Vellum Heartbeat?

Skills that share tags, products or a category with Vellum Heartbeat: Configure Channel (openclaw/openclaw, 392k stars), Python Background Jobs (wshobson/agents, 40k stars), Configuration (BuilderIO/agent-native, 7.1k stars) and Background (jeremylongshore/tons-of-skills-marketplace, 2.8k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Vellum Heartbeat?

vellum-ai (a GitHub organization) maintains it in vellum-ai/vellum-assistant, which has 1,408 GitHub stars. The repository holds 108 skills in this directory. The repository was last updated on October 9, 2026.

Source: vellum-ai/vellum-assistant on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.