ralph-signal-mailbox-protocol

Ralph-v2 live signal mailbox protocol for polling, ack handling, broadcast quorum, and signal routing. Use when a Ralph agent needs to process `signals/inputs`, write ack files, route target-specific signals, or finalize broadcast signals safely.

Jump to install

Repository: arisng/github-copilot-fc
Last source activity: August 28, 2026 at 04:25
Detected SKILL.md language: English
Stars: 5
Forks: 0

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

A direct command skips the review prompt. Inspect the source before running it.

npx skills add https://github.com/arisng/github-copilot-fc --skill ralph-signal-mailbox-protocol

The command stays on one line. Scroll horizontally to inspect it before copying.

Prefer a local copy? Download the files currently available to SkillsMP.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

SKILL.md

Source instructions · Read-only preview

name	ralph-signal-mailbox-protocol
description	Ralph-v2 live signal mailbox protocol for polling, ack handling, broadcast quorum, and signal routing. Use when a Ralph agent needs to process `signals/inputs`, write ack files, route target-specific signals, or finalize broadcast signals safely.

Ralph Signal Mailbox Protocol

This skill contains the authoritative live-signal mailbox rules for Ralph-v2 agents.

Signal Artifacts

Inputs: .ralph-sessions/<SESSION_ID>/signals/inputs/
Acks: .ralph-sessions/<SESSION_ID>/signals/acks/
Processed: .ralph-sessions/<SESSION_ID>/signals/processed/

Recognized Signal Types

STEER
PAUSE
ABORT
INFO

Target Namespace

ALL
Orchestrator
Executor
Planner
Questioner
Reviewer
Librarian

Never encode runtime or version in target.

Poll-Signals Routine

Ensure signals/acks/ exists.
Read signals/inputs/ in timestamp order.
For each candidate signal, inspect type and target before moving it.
Handle target: ALL by writing or refreshing signals/acks/<SIGNAL_ID>/<Agent>.ack.yaml and leaving the source signal in place.
Archive a broadcast signal only after ack quorum is satisfied for all required recipients.
For targeted signals:
- ABORT blocks work immediately.
- PAUSE waits.
- STEER changes execution context.
- INFO injects additional context.
Route target-specific signals to the named subagent by buffering context and moving the original file to signals/processed/.

Broadcast Invariant

The first agent that reads target: ALL never archives it.
Every recipient writes exactly one ack file per signal ID.
Only the Orchestrator archives the broadcast signal after quorum is met.

Completion Hygiene

Before a session ends, the Orchestrator should sweep remaining target: ALL signals and archive them with either:

delivery_status: delivered
delivery_status: partial plus unacked_agents

Back to search Back to installation

machina-driving

Drive a Machina state machine to a deterministic outcome on behalf of an AI agent. USE WHEN: a task is governed by a state machine (a machine definition JSON with states, transitions, guards, actions, tools, checks, scenarios); executing a workflow that must be deterministic and auditable; running a skill whose SKILL.md declares a `machina:` machine; firing events, checking status, satisfying evidence checks, verifying run integrity with `check`, or producing a terminal report for a machine-driven run; escalating a STUCK run to a human conductor. DO NOT USE FOR: authoring or scoring machine definitions (use machina-authoring); modifying the Machina simulator app or its engine (use machina-simulator); implementing or modifying the driver/runtime tooling such as `scripts/machine-driver.py` (engine development) unless you are a maintainer of this skill upgrading the driver itself; general diagramming or XState/SCXML authoring.

2026-09-09

machina-authoring

Author valid, high-scoring state machines in Machina machine JSON format (spec v3.0.0 / v2.0.0 / v1.0.0). USE WHEN: writing or generating a machine definition (states, transitions, guards, actions, context, scenarios); modeling a real workflow (order fulfillment, refunds, signup, retries) as a Machina state machine; fixing or upgrading a machine JSON for validation or higher compliance score; explaining validation failures or low scores; running the bundled machina-validator.py CLI to validate, score, or generate gaps/scenarios; adding retry guards or cycle protection; or preparing machines for the compliance scorer ("Excellent" ≥90). DO NOT USE FOR: modifying the Machina simulator app, its engine, UI, or SPEC_REGISTRY (use machina-simulator-maintenance), debugging machine-validator.py scripts, XState config authoring, SCXML documents, or general diagramming.

2026-09-08

copilot-cli-subsession

Spawn a new isolated Copilot CLI sub-session from a main Copilot CLI or VS Code session. Use when you need to programmatically create, resume, or chain Copilot CLI sessions with explicit control over session ID, custom agent, model, BYOK provider profile, permissions, and working directory. Triggers: "invoke copilot", "spawn copilot", "copilot sub-session", "programmatic copilot cli", "programmatic copilot subprocess", "copilot cli session id", "resume copilot session", "chain copilot sessions", "isolated copilot session", "subagent copilot cli", "task copilot cli".

2026-09-07

View all from this repository

name	ralph-signal-mailbox-protocol
description	Ralph-v2 live signal mailbox protocol for polling, ack handling, broadcast quorum, and signal routing. Use when a Ralph agent needs to process `signals/inputs`, write ack files, route target-specific signals, or finalize broadcast signals safely.

Ralph Signal Mailbox Protocol

This skill contains the authoritative live-signal mailbox rules for Ralph-v2 agents.

Signal Artifacts

Inputs: .ralph-sessions/<SESSION_ID>/signals/inputs/
Acks: .ralph-sessions/<SESSION_ID>/signals/acks/
Processed: .ralph-sessions/<SESSION_ID>/signals/processed/

Recognized Signal Types

STEER
PAUSE
ABORT
INFO

Target Namespace

ALL
Orchestrator
Executor
Planner
Questioner
Reviewer
Librarian

Never encode runtime or version in target.

Poll-Signals Routine

Ensure signals/acks/ exists.
Read signals/inputs/ in timestamp order.
For each candidate signal, inspect type and target before moving it.
Handle target: ALL by writing or refreshing signals/acks/<SIGNAL_ID>/<Agent>.ack.yaml and leaving the source signal in place.
Archive a broadcast signal only after ack quorum is satisfied for all required recipients.
For targeted signals:
- ABORT blocks work immediately.
- PAUSE waits.
- STEER changes execution context.
- INFO injects additional context.
Route target-specific signals to the named subagent by buffering context and moving the original file to signals/processed/.

Broadcast Invariant

The first agent that reads target: ALL never archives it.
Every recipient writes exactly one ack file per signal ID.
Only the Orchestrator archives the broadcast signal after quorum is met.

Completion Hygiene

Before a session ends, the Orchestrator should sweep remaining target: ALL signals and archive them with either:

delivery_status: delivered
delivery_status: partial plus unacked_agents

ralph-signal-mailbox-protocol

Source facts

Install options

Review the source files

Ralph Signal Mailbox Protocol

Signal Artifacts

Recognized Signal Types

Target Namespace

Poll-Signals Routine

Broadcast Invariant

Completion Hygiene

More from this repository

Ralph Signal Mailbox Protocol

Signal Artifacts

Recognized Signal Types

Target Namespace

Poll-Signals Routine

Broadcast Invariant

Completion Hygiene

More from this repository