← Back to Skills Marketplace
284
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install acp-loop
Description
Schedule recurring AI agent prompts using intervals or cron expressions. Use when users need to run prompts periodically, automate agent tasks on a schedule,...
README (SKILL.md)
acp-loop: Recurring Prompt Scheduler
Schedule AI agent prompts to run at intervals or cron schedules.
When to Use This Skill
Use this skill when the user:
- Wants to run a prompt repeatedly at fixed intervals
- Needs cron-style scheduling for agent tasks
- Wants to automate recurring AI workflows
- Asks about scheduling, looping, or periodic execution of prompts
Installation
npm install -g acp-loop
Quick Start
Interval Mode
Run prompts at fixed intervals:
# Every 5 minutes
acp-loop --interval 5m "check logs for errors"
# Every 30 seconds, stop after 10 iterations
acp-loop --interval 30s --max 10 "quick health check"
# Every hour, timeout after 8 hours
acp-loop --interval 1h --timeout 8h "hourly report"
Cron Mode
Run prompts on cron schedules:
# Daily at 3am
acp-loop --cron "0 3 * * *" "nightly cleanup"
# Every Monday at 9am
acp-loop --cron "0 9 * * 1" "weekly standup summary"
# Every 5 minutes (cron style)
acp-loop --cron "*/5 * * * *" "monitor status"
Options Reference
| Option | Description | Example |
|---|---|---|
--interval \x3Cduration> |
Fixed interval (30s, 5m, 1h) | --interval 5m |
--cron \x3Cexpression> |
Cron expression | --cron "0 9 * * *" |
--agent \x3Cname> |
Agent to use (default: codex) | --agent claude |
--max \x3Cn> |
Max iterations | --max 10 |
--timeout \x3Cduration> |
Max total runtime | --timeout 2h |
--until \x3Cstring> |
Stop when output contains | --until "DONE" |
--quiet |
Minimal output | --quiet |
Common Patterns
Conditional Stop
# Run until task reports completion
acp-loop --interval 1m --until "All tests passed" "run test suite"
Limited Runs
# Run exactly 5 times
acp-loop --interval 10s --max 5 "check deployment status"
Time-Boxed Execution
# Run for max 1 hour
acp-loop --interval 5m --timeout 1h "monitor build"
Daily Scheduled Task
# Every day at midnight
acp-loop --cron "0 0 * * *" "generate daily report"
Using Different Agents
# Use Claude instead of Codex
acp-loop --interval 10m --agent claude "review code changes"
# Use Gemini CLI
acp-loop --interval 5m --agent gemini-cli "check status"
Important Notes
- Mutually exclusive: Use either
--intervalOR--cron, not both - Cron library: Uses
croner(handles laptop sleep/wake better than node-cron) - Stop: Press Ctrl+C to stop the loop
- Agent support: Works with any ACP-compatible agent (codex, claude, gemini-cli)
Why acp-loop?
- Claude Code's built-in
/loopcommand has bugs - Works with any ACP-compatible agent, not just Claude
- Proper cron expression support
- Better handling of laptop sleep/wake cycles
Resources
Usage Guidance
This skill is coherent with its stated purpose, but it directs you to install and run an external npm package (acp-loop) that will execute on your machine. Before installing or running it: (1) inspect the npm package page and GitHub repo (source code, maintainers, recent activity, issues); (2) prefer not to run global installs on sensitive hosts—consider a container or VM; (3) verify what the CLI will access (local logs, files, network) and whether it requires agent credentials or other secrets; (4) if you plan to allow autonomous scheduled runs, restrict the agent's scope and monitor its outputs. If you want higher assurance, request the package's repository and installation checksum or run it in an isolated environment first.
Capability Analysis
Type: OpenClaw Skill
Name: acp-loop
Version: 0.1.0
The skill bundle provides instructions for an AI agent to use 'acp-loop', a utility designed to schedule recurring prompts via intervals or cron expressions. The documentation in SKILL.md is transparent, aligns with the stated purpose of automation, and contains no malicious instructions, obfuscation, or evidence of data exfiltration.
Capability Assessment
Purpose & Capability
The name/description (recurring prompt scheduler) matches the SKILL.md content. The CLI-based usage and options are coherent for scheduling tasks (intervals, cron, agent selection). Requiring an npm package to provide the CLI is proportionate to the stated purpose.
Instruction Scope
SKILL.md only instructs users to install and run the acp-loop CLI and shows examples of scheduled prompts. It does not instruct the agent to read unrelated files or environment variables. However some examples (e.g., "check logs for errors") imply access to local logs or system state — the skill does not specify how that access is obtained, or whether the CLI will read local files or require additional permissions, which is an ambiguity worth clarifying.
Install Mechanism
This is an instruction-only skill with no registry install spec, but the documentation points to installing via npm and links to GitHub/npm — both common, traceable sources. Because the actual code is external (npm package / GitHub repo), users should review that package before running a global install. No unusual or opaque download URLs are present in the SKILL.md.
Credentials
The skill declares no required environment variables or credentials, which is consistent with the documentation. One caveat: selecting external agents (claude, gemini-cli, etc.) may in practice require credentials or CLIs on the host; those needs are not declared here and should be verified before use.
Persistence & Privilege
The skill does not request always: true and does not ask to modify other skills or system-wide settings. Autonomous invocation (disable-model-invocation: false) is normal for skills and is not in itself concerning here.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install acp-loop - After installation, invoke the skill by name or use
/acp-loop - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.0
Initial release of acp-loop: Easily schedule recurring AI agent prompts with intervals or cron expressions.
- Run AI prompts at fixed intervals or using cron syntax.
- Supports stopping after max runs, timeout, or when output contains a string.
- Compatible with multiple agents (codex, claude, gemini-cli).
- Built-in options for quiet mode and flexible stopping conditions.
- Works reliably across system sleep/wake using the croner library.
Metadata
Frequently Asked Questions
What is Acp Loop?
Schedule recurring AI agent prompts using intervals or cron expressions. Use when users need to run prompts periodically, automate agent tasks on a schedule,... It is an AI Agent Skill for Claude Code / OpenClaw, with 284 downloads so far.
How do I install Acp Loop?
Run "/install acp-loop" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Acp Loop free?
Yes, Acp Loop is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Acp Loop support?
Acp Loop is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Acp Loop?
It is built and maintained by femto (@femto); the current version is v0.1.0.
More Skills