loop-runner

Automate bounded iterative processes with validation checks and stall detection.

2|Updated Jul 13, 2025
One-click install
npx skills add https://github.com/krzemienski/shannon --skill loop-runner-krzemienski
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: loop-runner
Source: https://github.com/krzemienski/shannon/tree/main/skills/loop-runner
Command: npx skills add https://github.com/krzemienski/shannon --skill loop-runner-krzemienski

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Loop-runner helps automate iterative processes by providing a bounded do-verify-reflect loop, ensuring that each iteration is provable with iron rule validation and preventing stalls.

Core Features & Use Cases

  • Bounded Iteration: Manages iterations within a defined boundary to prevent infinite loops.
  • Iron Rule Validation: Ensures that the verifying command's output appears in the transcript of the iteration.
  • Stall Detection: Detects if the same failure occurs three times in a row and stops further iterations.
  • Checklist Artifacts: Tracks progress and provides a persistent checklist across iterations.
  • Cleanup Pass: Ensures a mandatory cleanup pass after successful iterations.

Quick Start

Activate the loop-runner skill and start an iteration by invoking /shannon:loop with your task description.

Frequently Asked Questions about loop-runner

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

FAQPage Schema
How do I automate iterative processes with proof-of-completion validation?

Automate iterative processes using a bounded do-verify-reflect loop that requires iron rule validation, ensuring the verifying command's output appears in the iteration transcript for reliable proof-of-completion.

What is the best way to prevent infinite loops during task automation?

Prevent infinite loops during task automation by using bounded iteration management, which defines clear iteration boundaries and includes stall detection to stop processing if the same failure occurs three times in a row.

How do I track progress across multiple iterations of an automated task?

Track progress across iterations using checklist artifacts, which provide a persistent checklist that maintains state and verification outputs across each bounded loop execution.

When do I need iron rule validation for iteration control?

Iron rule validation is needed for iteration control when your automated tasks require verifiable outcomes and accountability, ensuring validating command outputs are captured in the transcript before proceeding.

Does loop automation require a cleanup pass after successful iterations?

Loop automation requires a mandatory cleanup pass after successful iterations, ensuring all resources and states are properly finalized once the bounded do-verify-reflect loop completes its verification.

What are the limitations of bounded iteration management for task automation?

Bounded iteration management is limited to tasks with a defined iterative structure and clear iteration boundaries; it is not suited for unbounded processes or tasks lacking consistent verification outputs and provable steps.