poll

Poll a tool at fixed intervals until a condition is met.

Updated Jan 4, 2026
One-click install
npx skills add https://github.com/c-daly/agent-swarm --skill poll
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: poll
Source: https://github.com/c-daly/agent-swarm/tree/main/skills/poll
Command: npx skills add https://github.com/c-daly/agent-swarm --skill poll

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides deterministic polling for asynchronous operations by repeatedly invoking a tool at fixed intervals until a specified condition is met.

Core Features & Use Cases

  • Configurable polling: Waits for a condition to become true by checking at regular intervals.
  • Versatile triggers: Useful for monitoring CI/CD status, code review approvals, or any long-running task.
  • Controlled termination: Supports a maximum number of iterations to avoid infinite loops and to provide a final result.

Quick Start

Use the poll skill to wait for a code review to reach status COMPLETED.

Frequently Asked Questions about poll

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

FAQPage Schema
How do I wait for a CI/CD check or code review to complete automatically?

Polling repeatedly checks a tool at fixed intervals until a specified condition is met. Configure an interval, target tool, condition field, and expected value—the Skill invokes the tool automatically until the condition becomes true, making it ideal for monitoring CI/CD status or code review approvals without manual intervention.

Can I poll asynchronous workflows to avoid infinite loops?

Yes. The Skill supports configurable max_iterations to limit polling attempts and prevent infinite loops. Set your interval, condition, and maximum iteration count; polling stops when the condition is met or the iteration limit is reached, ensuring controlled termination.

What's required to set up polling for long-running operations?

Define an interval for check frequency, identify the target tool to invoke, specify the condition field and expected value to match, and optionally set max_iterations. The Skill then polls deterministically until the condition is satisfied or iterations are exhausted.

How does polling work with code review status checks?

Polling monitors the code review tool at regular intervals, checking a specified field—such as status—against an expected value like COMPLETED. It repeats automatically at your configured interval until the condition matches, automating the wait for approval.

Can I use polling for multiple asynchronous tasks in the same workflow?

Yes. The Skill's configurable parameters—interval, condition field, expected value, and max_iterations—apply to any tool and long-running operation, making it versatile for CI/CD checks, code reviews, or other asynchronous tasks in automation workflows.