rad-issue-loop

Automate Radicle issue processing into direct implementations or Plan COBs.

2|Updated Mar 9, 2026
One-click install
npx skills add https://github.com/deanh/rad-pi --skill rad-issue-loop
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: rad-issue-loop
Source: https://github.com/deanh/rad-pi/tree/main/skills/rad-issue-loop
Command: npx skills add https://github.com/deanh/rad-pi --skill rad-issue-loop

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill automates the gap between open Radicle issues and actionable work by scanning issues, generating structured plans for complex tasks, and executing simple tasks directly so maintainers can reduce manual triage and coordination overhead.

Core Features & Use Cases

  • Automated Issue Processing: Continuously watches a repository for open issues and either handles simple issues directly or generates Plan COBs for complex work.
  • Plan Creation & Orchestration: Converts TODO-labeled issues into Plan COBs with task breakdowns, links plans to issues, swaps labels, and dispatches approved plans to orchestrated worktrees.
  • Use Case: Run the plan loop to convert backlog TODO issues into draft plans, review and approve a plan, then let the orchestrator execute tasks across isolated worktrees to produce patches and Context COBs.

Quick Start

Start the plan loop to convert TODO-labeled issues into Plan COBs and dispatch approved plans by running the /rad-plan-loop and /rad-orchestrate-loop commands in a Radicle-enabled repository.

Frequently Asked Questions about rad-issue-loop

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate Radicle issue triage and plan creation?

Automating Radicle issue triage is done by running the plan loop to scan open issues, directly resolve simple tasks, and generate structured Plan COBs for complex work. This reduces manual backlog coordination by converting TODO-labeled issues into actionable plans.

What is a Radicle Plan COB and how does it help issue orchestration?

A Radicle Plan COB is a structured collaborative object that breaks complex issues into executable tasks. It links to the originating issue, swaps labels, and enables the orchestrator to dispatch approved work across isolated worktrees to produce patches and Context COBs.

Do I need a running Radicle node and specific CLIs to use automated issue planning?

Yes, automated issue planning requires a running Radicle node, the rad CLI, rad-plan and rad-context CLIs, and LLM access. These components provide the repository access, plan generation, and task orchestration capabilities needed to process issues and execute worktrees.

How do I execute approved Radicle plans across isolated worktrees?

Executing approved Radicle plans uses the orchestrator loop to dispatch tasks across isolated worktrees. Once you review and approve a generated Plan COB, the orchestrator autonomously processes the tasks to produce code patches and Context COBs.

Can I convert backlog TODO issues into draft plans automatically in Radicle?

Yes, you can automatically convert backlog TODO issues into draft plans by running the /rad-plan-loop command in a Radicle-enabled repository. The loop scans for TODO-labeled issues and uses LLM access to generate structured Plan COBs for complex tasks.

What are the limitations of automating Radicle issue processing?

Automating Radicle issue processing is limited to Radicle repositories and depends on a running Radicle node, specific rad CLIs, and LLM access. It cannot process issues without the TODO label and requires manual review before dispatching complex plans for worktree execution.