arisng/ralph-signal-mailbox-protocol
skills/ralph-signal-mailbox-protocol/SKILL.md
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.
$ install --global
skillsauthnpx skillsauth add arisng/github-copilot-fc ralph-signal-mailbox-protocolInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 13, 2026, 3:34 AM141.4s1 file scanned
SKILL.md
- 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
STEERPAUSEABORTINFO
Target Namespace
ALLOrchestratorExecutorPlannerQuestionerReviewerLibrarian
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
typeandtargetbefore moving it. - Handle
target: ALLby writing or refreshingsignals/acks/<SIGNAL_ID>/<Agent>.ack.yamland leaving the source signal in place. - Archive a broadcast signal only after ack quorum is satisfied for all required recipients.
- For targeted signals:
ABORTblocks work immediately.PAUSEwaits.STEERchanges execution context.INFOinjects 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: ALLnever 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: delivereddelivery_status: partialplusunacked_agents
Related Skills
arisng/tldraw-creator
devops
VerifiedTrustedCommunity
Programmatically create tldraw whiteboards and visualize them with a self-hosted tldraw instance. Create boards with shapes, text, and connectors, then deploy to a self-hosted server for collaborative editing and gallery management.
3SKILL.mdUpdated May 30, 2026
arisng/gcloud-cli
tools
VerifiedTrustedCommunity
Execute Google Cloud Platform operations using the gcloud CLI (and gsutil/bq where applicable). Use when the user wants to: authenticate with GCP, manage GCP resources, deploy applications, configure projects or IAM, view logs, run SQL/BigQuery, or interact with any GCP service from the command line. Triggers on phrases like "gcloud", "Google Cloud CLI", "deploy to GCP", "create a VM", "Cloud Run", "GKE cluster", "Cloud Storage bucket", "set GCP project", "service account", "Cloud Functions", "App Engine deploy", or any request to manage Google Cloud resources via command line.
3SKILL.mdUpdated May 29, 2026
arisng/grill-with-docs
testing
VerifiedTrustedCommunity
Grilling session that challenges your plan against the existing domain model, sharpens terminology, and updates documentation (CONTEXT.md, ADRs) inline as decisions crystallise. Use when user wants to stress-test a plan against their project's language and documented decisions.
3SKILL.mdUpdated May 26, 2026
arisng/git-session-atomic-commits
development
VerifiedTrustedCommunity
Session-scoped git commit orchestrator that commits only current-session changes and leaves unrelated dirty worktree edits untouched. Inherits git-atomic-commit for atomic grouping and commit message execution, and git-commit-scope-constitution for scope governance and validation. Use when asked to commit this session only or isolate commits from mixed worktree state.
3SKILL.mdUpdated May 23, 2026