Checkpointed Agent Loop

Use for long-running or failure-prone WorkBuddy tasks that need bounded retries, durable recovery state, and explicit verification evidence before completion.

9 stars 3 forksAI, LLMs & Agents

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add sandbaseai/workbuddy-skill --skill checkpointed-agent-loop
Manual install
git clone --depth 1 https://github.com/sandbaseai/workbuddy-skill.git /tmp/workbuddy-skill
mkdir -p ~/.claude/skills
cp -r /tmp/workbuddy-skill/skills/checkpointed-agent-loop ~/.claude/skills/checkpointed-agent-loop

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Checkpointed Agent Loop

## Purpose

Use a durable checkpoint when work may span sessions, be interrupted, require bounded retries, or need proof that verification actually ran. The checkpoint stores task state, a next action, attempt count, sanitized reasons, and verification evidence. It does not execute commands, call models, spawn Agents, access secrets, or contact a network service; WorkBuddy remains responsible for each tool call and policy decision.

Do not use this for a one-line edit or a workflow that already has its own durable runner. A checkpoint is recovery state, not a license to loop forever or bypass approval.

## State machine

Only these states and transitions are valid:

```text
planned -> running
running -> verifying | failed | blocked
verifying -> succeeded | running | failed | blocked
```

Entering `running` consumes one attempt. A finite positive `max_attempts` cannot be exceeded. `succeeded`, `failed`, and `blocked` are terminal; terminal state cannot be edited. `succeeded` is rejected unless at least one `passed` evidence record was added while in `verifying`.

## Initialize safely

Choose a project-local checkpoint path excluded from application commits, such as `.agent/checkpoints/task.json`. Verify the directory and ignore policy before use. Keep objectives, reasons, check names, and artifact paths free of API keys, tokens, passwords, PII, and raw secret-bearing logs.
Read the full skill on GitHub

Details

Skill name
checkpointed-agent-loop
Path
skills/checkpointed-agent-loop/SKILL.md
License
MIT
Repo updated
8 September 2026

FAQ

What does the Checkpointed Agent Loop skill do?

Use for long-running or failure-prone WorkBuddy tasks that need bounded retries, durable recovery state, and explicit verification evidence before completion.

How do I install the Checkpointed Agent Loop skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add sandbaseai/workbuddy-skill --skill checkpointed-agent-loop. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Checkpointed Agent Loop popular?

It lives in sandbaseai/workbuddy-skill, which has 9 GitHub stars and 3 forks.

Related skills

Access Control Security Best Practices

9

sandbaseai/workbuddy-skill

Design, review, implement, and verify least-privilege access controls across users, services, tenants, resources, and administrative workflows.

Security

Accessibility Review

9

sandbaseai/workbuddy-skill

Use when reviewing a web interface or interaction for semantic, keyboard, focus, screen-reader, ARIA, and contrast accessibility risks.

Frontend & Design

Acquire Codebase Knowledge

9

sandbaseai/workbuddy-skill

Use when the user asks to map, document, or onboard into an existing codebase and needs evidence-backed architecture, structure, conventions, integrations, testing, and concerns documentation.

Software Development

Confidence Gated Routing

9

sandbaseai/workbuddy-skill

Use before delegating work to multiple agents or model tiers; assign the cheapest verifiable tier, escalate only objective failure or disagreement residue, and preserve an auditable handoff.

AI, LLMs & Agents

AI Team Orchestration

9

sandbaseai/workbuddy-skill

Bootstrap and run a lightweight multi-agent development team. Use when starting or adopting a project, planning work, coordinating implementation and optional QA, brainstorming with distinct perspectives, or preserving context across sessions.

AI, LLMs & Agents

Context Management

5

Sagargupta16/claude-skills

Use when managing Claude Code context window during long sessions, when context feels degraded, or when deciding between /compact, /clear, /rewind, and sub-agents. Covers context rot detection, compaction timing, branching strategy, and sub-agent isolation patterns.

AI, LLMs & Agents

Browse the most popular Claude skills, all ai, llms & agents skills, or write your own with the skills generator.