Why use this skill instead of editing JSON manually?

Manual edits are prone to syntax errors and race conditions. This skill uses deterministic jq commands for atomic, safe, and predictable updates to the marathon-ralph state file.

Can I reset the tracking if I fix a recurring issue?

Yes, the skill provides specific commands like 'reset-issue-tracking' and 'reset-on-success' to clear failure signatures and counters when a task is successfully resolved.

Does this skill increase my token usage?

No, the skill executes via shell scripts locally. It performs state updates without loading the entire JSON file into the LLM's context, providing zero-token overhead.

What happens if a specific coding phase fails repeatedly?

The skill can detect repeated error signatures and increment attempt counters. Once limits are hit, it can programmatically skip a phase or an entire issue to prevent wasted resources.

How does the circuit breaker system work?

It tracks attempts and error signatures across different phases (like plan, code, and test), automatically skipping tasks or aborting the marathon if pre-defined failure limits are reached.

Marathon State Manager

Name: Marathon State Manager
Author: gruckion

bygruckion

•

生産性とワークフロー

Manages and synchronizes project state using deterministic jq commands to ensure reliable task tracking and circuit breaking.

The update-state skill provides a robust, script-based interface for managing the execution state of marathon-ralph projects. By utilizing deterministic jq operations instead of manual JSON editing, it ensures that project phases, issue tracking, and failure metrics are updated atomically and accurately. It is essential for maintaining consistency during long-running autonomous coding sessions, offering built-in failure tracking and circuit breaker patterns to prevent infinite loops and manage complex task transitions without increasing token consumption.

主な機能

01Zero-token overhead execution for efficient context management

02Deterministic state updates via jq to prevent JSON corruption

03Phase-specific attempt monitoring and error signature detection

04Comprehensive failure tracking with built-in circuit breaker logic

05Automated issue progression including start, complete, and skip actions

069 GitHub stars

ユースケース

01Maintaining a precise, programmatic audit log of task progress and completion stats

02Preventing infinite loops during autonomous sessions via failure limits and error signatures

03Automating transitions between coding, testing, and QA phases in a development marathon

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add gruckion/marathon-ralph update-state

For use in Claude.ai and ChatGPT

Download Skill