# afk-loop

The afk-loop Claude Code skill lays out a manual workflow for delegating work to coding agents and reviewing their pull requests. It helps distinguish tasks for Copilot from work that needs Claude Code and human input.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 792 installs
- Author: clhbid
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/clhbid/agent-context/tree/HEAD/skills/afk-loop/SKILL.md
- Updated: 2026-11-16
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/afk-loop

## What it does

afk-loop describes how a team hands issues to coding agents and handles the pull requests they return. It separates work that Copilot can complete from tasks that need a person involved, and sets out what an agent brief should cover, including expected behavior, acceptance criteria, and changes that must stay out of scope. A person dispatches each issue; changing its status does not start a workflow.

When a review request arrives, the procedure first classifies the run as complete, blocked, or errored, then follows the matching path. Run-ending rules come from the repository's own `AGENTS.md`. The workflow also uses GitHub and `gh` to assign Copilot and check whether a run began.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add clhbid/agent-context --skill afk-loop -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/afk-loop/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/afk-loop/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add clhbid/agent-context --skill afk-loop -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/afk-loop/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add clhbid/agent-context --skill afk-loop -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/afk-loop/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install clhbid/agent-context skills/afk-loop
```

2. **Manually: put the files in place**
- File: `.github/skills/afk-loop/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add clhbid/agent-context --skill afk-loop -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/clhbid/agent-context --path skills/afk-loop
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/afk-loop/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add clhbid/agent-context --skill afk-loop -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/clhbid/agent-context/tree/HEAD/skills/afk-loop/SKILL.md

## When to use it
- write an issue brief with verifiable acceptance criteria
- choose whether to assign work to Copilot or Claude Code
- check whether an agent run has started
- handle a blocked run or decide where failed work goes next

## Example prompts
- Prepare this issue for Copilot and check whether its acceptance criteria are testable.
- Classify the agent's pull request as complete, blocked, or errored, then tell me what to do next.
- Explain how to handle a failed run before returning the issue to the queue.

## Similar
- [om-auto-create-pr-loop](https://affpapa.org/en/nevibecode/skills/om-auto-create-pr-loop.md) — skill · 4700 installs
- [om-auto-continue-pr-loop](https://affpapa.org/en/nevibecode/skills/om-auto-continue-pr-loop.md) — skill · 4600 installs
- [ship-ci-review-loop](https://affpapa.org/en/nevibecode/commands/ship-ci-review-loop.md) — command · ★ 2003 repo stars
- [loop-verifier](https://affpapa.org/en/nevibecode/skills/loop-verifier.md) — skill · ★ 11819 repo stars
- [autofix](https://affpapa.org/en/nevibecode/skills/autofix.md) — skill · 12100 installs
- [github-issue-workflow](https://affpapa.org/en/nevibecode/skills/github-issue-workflow.md) — skill · 3700 installs

From the same set: [clhbid/agent-context](https://affpapa.org/en/nevibecode/by/clhbid/agent-context.md) — 8 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
