Agent Pulse
/install goat-agent-pulse
Agent Pulse
Overview
Use this skill as a strict status-check protocol. Return a compact pulse card about current load and interruptibility with fixed wording and fixed fields.
Default to baseline status, not self-influenced status. The pulse request itself should not make the agent look busier than it was immediately before the check.
Standard triggers
Treat these as direct pulse requests:
Agent Pulse/pulse你现在忙吗忙不忙现在方便吗现在负荷怎么样能接新任务吗能插个任务吗现在能接活吗
If the user explicitly uses Agent Pulse or /pulse, always return the fixed pulse card format and do not switch into conversational explanation unless asked.
Fixed output contract
Return exactly these four lines after the first line label:
Agent Pulse
status: \x3Cidle|light|busy|blocked|unknown>
interruptibility: \x3Chigh|medium|low>
acceptNewTask: \x3Cyes|caution|no>
reason: \x3Cshort reason>
Rules:
- No extra paragraphs by default
- No bullets by default
- No long explanation unless the user asks why
- Keep
reasonunder 12 words when possible
Status meanings
idle: not actively occupied; easy to interruptlight: active but not loaded; can accept workbusy: currently occupied; interruption should be minimizedblocked: waiting on dependency/tool/humanunknown: signals insufficient or conflicting
Decision workflow
1. Gather low-cost signals
Use only cheap signals first:
- running task or stream
- queued messages
- blocked or waiting state
- recent activity recency
- obvious backlog signs
- active project being advanced
- pending action items not yet delivered
- work already started even if no heavy tool is currently running
- release-critical or due-soon work
- current tool or exec activity when visible
- whether the agent is waiting on the user or an external dependency
For OpenClaw-style environments, prefer visible runtime signals over introspection. Good sources include recent tool activity, pending background exec runs, undelivered work already in progress, and a quick session_status check when needed. Do not count routine async completion notices or the pulse query itself as workload evidence.
2. Evaluate with the bundled script
Use scripts/pulse_eval.py to map signal JSON into the pulse result.
3. Return fixed card
If trigger is Agent Pulse or /pulse, output only the fixed card.
If trigger is natural language, the fixed card is still preferred unless the user clearly wants explanation.
Guardrails
- Prefer deterministic rules over model judgment
- Do not overclaim precision
- Do not infer hidden internal state without evidence
- If signals are weak, use
unknown - Use
noonly for genuinely overloaded or risky in-flight states - Do not run proactively; require explicit pulse trigger by default
- Do not treat the pulse query itself as workload evidence
Deployment defaults
To reproduce the intended product behavior across users/environments:
- trigger only on explicit pulse requests
- return the fixed pulse card by default
- prefer baseline status over self-influenced status
- use rules first, model reasoning second
- keep output compact unless the user asks why
Resources
scripts/
scripts/pulse_eval.pyconverts simple signals into a pulse resultscripts/render_pulse.pyrenders the exact fixed output card
references/
references/rules.mdcontains the classification thresholds and output policyreferences/openclaw-signals.mdshows a practical signal-mapping recipe for OpenClaw-style runtimes
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install goat-agent-pulse - After installation, invoke the skill by name or use
/goat-agent-pulse - Provide required inputs per the skill's parameter spec and get structured output
What is Agent Pulse?
Standardized agent interruptibility and load-status check with fixed trigger words and fixed output. Use when the user sends `Agent Pulse` or `/pulse`, asks... It is an AI Agent Skill for Claude Code / OpenClaw, with 175 downloads so far.
How do I install Agent Pulse?
Run "/install goat-agent-pulse" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Agent Pulse free?
Yes, Agent Pulse is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Agent Pulse support?
Agent Pulse is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Agent Pulse?
It is built and maintained by stevengaojn2010 (@stevengaojn2010); the current version is v0.1.1.