completion-marker-optimization

Enforce atomic output of the `<ralph>COMPLETE</ralph>` marker for reliable task completion signaling.

2|Updated Feb 13, 2026
One-click install
npx skills add https://github.com/pmarashian/cursor-agent-skills --skill completion-marker-optimization
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: completion-marker-optimization
Source: https://github.com/pmarashian/cursor-agent-skills/tree/main/completion-marker-optimization
Command: npx skills add https://github.com/pmarashian/cursor-agent-skills --skill completion-marker-optimization

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill addresses critical issues where AI agents fail to signal task completion reliably due to improper formatting or streaming of a special completion marker, leading to timeouts and task failures.

Core Features & Use Cases

  • Atomic Marker Output: Ensures the <ralph>COMPLETE</ralph> marker is sent as a single, indivisible unit to prevent detection failures.
  • Timeout Prevention: Significantly reduces task execution time by avoiding delays caused by the orchestrator's inability to detect completion.
  • Use Case: When an AI agent finishes a complex coding task, it must output <ralph>COMPLETE</ralph> as a single, immediate response after its final verification summary to ensure the orchestrator registers the task as successfully finished without timing out.

Quick Start

Output the completion marker <ralph>COMPLETE</ralph> as a single, atomic string immediately after your final verification summary.

Frequently Asked Questions about completion-marker-optimization

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

FAQPage Schema
Why does my agent protocol orchestrator timeout before task completion is detected?▼

Agent protocol orchestrators timeout when completion markers are output character-by-character or streamed, delaying detection. Forcing atomic output of the completion marker as a single indivisible unit ensures immediate registration and prevents task execution timeouts.

How do I prevent streaming issues from breaking task reliability in agentic systems?▼

To prevent streaming issues from breaking task reliability, output the completion marker as a single atomic string immediately after the final verification summary. This prevents character-by-character output delays that cause orchestrator detection failures and workflow interruptions.

What is atomic marker output and when is it needed for agent protocol workflows?▼

Atomic marker output sends the completion marker as a single, indivisible unit rather than a streamed sequence. It is needed when agentic systems require immediate completion detection to maintain workflow integrity and prevent orchestrator timeouts caused by delayed signal processing.

How do I format a completion marker to ensure reliable task completion signaling?▼

Format the completion marker by outputting `<ralph>COMPLETE</ralph>` as a single, immediate atomic string after your final verification summary. This strict formatting approach ensures the orchestrator detects the signal instantly and registers the task as successfully finished.

Does this atomic output approach work for any agent protocol or workflow context?▼

This atomic output approach works for agentic systems where orchestrators rely on specific completion markers to register task status. It suits complex coding tasks and workflow contexts where delayed detection or improper formatting of signals previously caused execution failures.

What happens if a completion marker is not sent as a single indivisible unit?▼

If a completion marker is not sent as an indivisible unit, character-by-character streaming causes delayed detection. The orchestrator fails to register task completion promptly, leading to unnecessary task execution delays, workflow integrity issues, and eventual system timeouts.