# Plan loop

> Plan loop is an open-source agent skill. Use when the user has a coding or engineering prompt and wants it refined into a detailed, executable plan before any code is written — the. It is available on Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, Windsurf and Goose.

- **Kind:** Skill
- **Pricing:** Open source
- **Platforms:** Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, Windsurf, Goose
- **Website:** https://github.com/gaasher/Agent-Loop-Skills/tree/main/loops/plan-loop
- **Repository:** https://github.com/gaasher/agent-loop-skills
- **GitHub stars:** 183
- **License:** MIT
- **Skill name:** plan-loop
- **Collection:** https://github.com/gaasher/Agent-Loop-Skills
- **Listing updated:** 2026-11-17

## About

Use when the user has a coding or engineering prompt and wants it refined into a detailed, executable plan before any code is written — the planning stage of a prompt → plan → execute → debug pipeline. It decomposes the prompt from first principles (objective, end state, environment, building blocks, tools, packages), breaks the work into PR-sized tasks each tied to a component with its files, tests, and dependencies, orders them topologically, splits each into atomic subtasks, then a separate principal-engineer agent critiques the plan for alignment, coverage, sizing, and executability; it revises until the critique passes, emitting a plan.md layout and a structured tasks.json that a junior engineer or a smaller model can execute correctly. Not for executing, scaffolding, or debugging the plan (those are downstream loops), and not for research proposals or experiment plans.

## When your agent uses it

> Use when the user has a coding or engineering prompt and wants it refined into a detailed, executable plan before any code is written — the planning stage of a prompt → plan → execute → debug pipeline. It decomposes the prompt from first principles (objective, end state, environment, building blocks, tools, packages), breaks the work into PR-sized tasks each tied to a component with its files, tests, and dependencies, orders them topologically, splits each into atomic subtasks, then a separate principal-engineer agent critiques the plan for alignment, coverage, sizing, and executability; it revises until the critique passes, emitting a plan.md layout and a structured tasks.json that a junior engineer or a smaller model can execute correctly. Not for executing, scaffolding, or debugging the plan (those are downstream loops), and not for research proposals or experiment plans.

## What it can access

From a static check of the files on GitHub; nothing was run.

- [Runs Python scripts](https://github.com/gaasher/Agent-Loop-Skills/tree/HEAD/loops/plan-loop)
- [No network calls found in its scripts](https://github.com/gaasher/Agent-Loop-Skills/tree/HEAD/loops/plan-loop)
- [License: MIT](https://github.com/gaasher/Agent-Loop-Skills/tree/HEAD/loops/plan-loop)

## Install

### Claude Code

This skill ships in the `agent-loops` plugin. In Claude Code, add the marketplace and install the plugin (it may include other skills too):

```sh
/plugin marketplace add gaasher/Agent-Loop-Skills
/plugin install agent-loops@agent-loop-skills
```

Or copy only this skill to `~/.claude/skills/plan-loop`:

```sh
tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/gaasher/Agent-Loop-Skills.git "$tmp" &&
mkdir -p ~/.claude/skills &&
rm -rf ~/.claude/skills/plan-loop &&
cp -R "$tmp/loops/plan-loop" ~/.claude/skills/plan-loop &&
rm -rf "$tmp"
```

For one project only, put the folder in `.claude/skills/plan-loop` inside it instead.

### Codex

Copy the skill folder to `~/.agents/skills/plan-loop` to use it in every repository:

```sh
tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/gaasher/Agent-Loop-Skills.git "$tmp" &&
mkdir -p ~/.agents/skills &&
rm -rf ~/.agents/skills/plan-loop &&
cp -R "$tmp/loops/plan-loop" ~/.agents/skills/plan-loop &&
rm -rf "$tmp"
```

For one repository only, put the folder in `.agents/skills/plan-loop` inside it instead.

### Cursor

Copy the skill folder to `~/.cursor/skills/plan-loop` to use it in every project:

```sh
tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/gaasher/Agent-Loop-Skills.git "$tmp" &&
mkdir -p ~/.cursor/skills &&
rm -rf ~/.cursor/skills/plan-loop &&
cp -R "$tmp/loops/plan-loop" ~/.cursor/skills/plan-loop &&
rm -rf "$tmp"
```

For one project only, put the folder in `.cursor/skills/plan-loop` inside it instead.

### Gemini CLI

Run in a terminal (add `--scope workspace` to install it for the current workspace only):

```sh
gemini skills install https://github.com/gaasher/Agent-Loop-Skills.git --path loops/plan-loop
```

Or copy the folder to `~/.gemini/skills/plan-loop` yourself.

### VS Code

For GitHub Copilot in VS Code, copy the skill folder to `~/.copilot/skills/plan-loop`:

```sh
tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/gaasher/Agent-Loop-Skills.git "$tmp" &&
mkdir -p ~/.copilot/skills &&
rm -rf ~/.copilot/skills/plan-loop &&
cp -R "$tmp/loops/plan-loop" ~/.copilot/skills/plan-loop &&
rm -rf "$tmp"
```

For one project only, put the folder in `.github/skills/plan-loop` inside it instead.

### Other agents

Get the folder:

```sh
git clone --depth 1 https://github.com/gaasher/Agent-Loop-Skills.git
```

Then copy `Agent-Loop-Skills/loops/plan-loop` into your agent's skills folder as `plan-loop`. Agents that support SKILL.md read one folder per skill.

## FAQ

### How do I install Plan loop in Claude Code?

Copy the skill folder from GitHub to ~/.claude/skills/plan-loop to use it in all your projects, or to .claude/skills/plan-loop in one project. Or install the agent-loops plugin, which includes it: /plugin marketplace add gaasher/Agent-Loop-Skills, then /plugin install agent-loops@agent-loop-skills.

### Does Plan loop run scripts?

Yes. It runs Python scripts. No network calls were found in its scripts. This comes from a static check of the files on GitHub; nothing was run. Read the files before you install it.

### Which AI agents can use Plan loop?

Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, Windsurf and Goose. Each reads skills in the SKILL.md format from its own folder; the install steps on this page list them.

---
Source: https://ai-powered.com/skills/plan-loop
