waggle-protocol

Define a universal protocol for coordinating AI agent tasks with 14 core fields and a 6-state lifecycle.

3|Updated Mar 21, 2026
One-click install
npx skills add https://github.com/kazukinagata/waggle --skill waggle-protocol
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: waggle-protocol
Source: https://github.com/kazukinagata/waggle/tree/main/skills/waggle-protocol
Command: npx skills add https://github.com/kazukinagata/waggle --skill waggle-protocol

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Waggle Protocol provides a universal specification for coordinating independent AI agents through a shared task board, enabling decoupled backends and scalable collaboration.

Core Features & Use Cases

  • 14 core fields and a 6-state machine ensure consistent task lifecycle management across providers.
  • Supports extended fields for context, artifacts, and project metadata, enabling flexible integrations.
  • Use Case: Build a Waggle-compliant task board backend that can dispatch tasks to multiple agents and consolidate results.

Quick Start

Consult the Waggle Protocol v1 specification to implement a compliant Waggle task board in your backend.

Frequently Asked Questions about waggle-protocol

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

FAQPage Schema
How do I coordinate independent AI agents on a shared task board?

You can coordinate independent AI agents on a shared task board by implementing the Waggle Protocol, which defines a universal specification with 14 core fields and a 6-state machine for consistent task lifecycle management across providers.

How does stall detection work for cross-agent task dispatch?

Stall detection for cross-agent task dispatch works through enforced constants within the Waggle Protocol specification, ensuring the backend monitors and correctly manages the task lifecycle to prevent agents from hanging indefinitely.

Can I use my own backend storage for multi-agent task coordination?

Yes, you can use your own backend storage for multi-agent task coordination as long as it implements the Waggle Protocol's 14 core fields, 6-state lifecycle, and provider interfaces to maintain dispatch readiness.

What is the best way to manage task lifecycle states across multiple AI providers?

The best way to manage task lifecycle states across multiple AI providers is applying a universal protocol like Waggle, which enforces a 6-state machine and dispatch readiness checks to ensure consistent state transitions and decoupled backend collaboration.

Does cross-agent task coordination support extended fields for project metadata and artifacts?

Yes, cross-agent task coordination supports extended fields for context, artifacts, and project metadata. The Waggle Protocol specifies these extended fields to enable flexible integrations alongside its 14 core fields.

Why do my dispatched AI agent tasks fail readiness checks on a shared task board?

Dispatched AI agent tasks fail readiness checks on a shared task board when the backend storage does not strictly implement the provider interfaces and dispatch readiness checks defined by the Waggle Protocol specification.