acpbot

Documentation

Skills

Bundled telegram, schedules, multi-agent, autoreview, eve skills and global install.

acpbot ships operator skills for coding agents (Grok, Claude, Codex, …):

SkillPackage pathPurpose
telegramskills/telegram/SKILL.mdProgress pings, mid-turn text, photos, files, voice via host MCP acpbot
schedulesskills/schedules/SKILL.mdCreate / list / cancel / fire delayed or recurring jobs
multi-agentskills/multi-agent/SKILL.mdSpawn parent-linked children (agent_* tools, worktrees) — Multi-agent
autoreviewskills/autoreview/SKILL.mdDual-agent closeout review (/review, review_run) — Review
eveskills/eve/SKILL.mdBackground multi-agent directives (JS graphs) — EVE

Skills are embedded in the release binary. Telegram /skills discovers them automatically. Install globally so agent CLIs also see them in every workspace.

Durable session memory is left to each coding agent (its own tools / project notes); acpbot does not ship a host-side memory skill or memory_* MCP tools.

Install

acpbot skills install

Run after setup or skill upgrades. The worker does not install skills on boot.

Install targets (symlink preferred, copy fallback). Never overwrites a real directory that is not already an acpbot skill symlink:

  • ~/.agents/skills/{telegram,schedules,multi-agent,autoreview,eve}
  • ~/.grok/skills/{telegram,schedules,multi-agent,autoreview,eve}
  • ~/.claude/skills/{telegram,schedules,multi-agent,autoreview,eve}

Binary installs materialise skills under ~/.local/share/acpbot/bundled-skills/ when the package tree is not on disk.

Discovery

PathWho uses it
Bundled root (package or materialised)Always on skillRoots for Telegram /skills
~/.agents/skills, ~/.grok/skills, ~/.claude/skillsGlobal agent CLIs after acpbot skills install
Session cwd .agents/skills (etc.)Per-repo overrides

Extra roots: [skills].roots in config.toml, or env ACPBOT_SKILL_ROOTS (colon / semicolon / comma separated). See Configuration.

Telegram /skills

In a topic, /skills lists skills from config roots + session cwd, then composes a prompt for the agent with the chosen skill body.

  • MCP — host tools those skills describe
  • Schedules — how host fire works
  • Multi-agent — spawn / wait / worktrees
  • Review — dual-agent closeout (/review, review_run)
  • EVE — background directives over those tools
  • Worker API — how outbound Telegram is delivered